[feature] sql_get_all default sort by lastRequestTime DESC

.dockerignore

@@ -1,6 +1,7 @@
+# default
 .git*
-*.md
-LICENSE
-img/
 maintain/
-project*
+LICENSE
+*.md
+img/
+node_modules/

.gitattributes

@@ -1,2 +1 @@
-# Auto detect text files and perform LF normalization
-* text=auto
+* text eol=lf

.github/workflows/docker.yml

@@ -1,8 +1,15 @@
 name: docker
+run-name: ${{ inputs.run-name }}
 
 on:
   workflow_dispatch:
     inputs:
+      run-name:
+        description: 'set run-name for workflow (multiple calls)'
+        type: string
+        required: false
+        default: 'docker'
+
       release:
         description: 'set WORKFLOW_GITHUB_RELEASE'
         required: false
@@ -46,7 +53,8 @@ jobs:
       - name: init / checkout
         uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
         with:
-          ref: master
+          ref: ${{ github.ref_name }}
+          fetch-depth: 0
 
       - name: init / inputs to env
         if: github.event_name == 'workflow_dispatch'
@@ -55,6 +63,7 @@ jobs:
           ${{ toJSON(github.event.inputs) }}
           EOF
           for KEY in $(cat .inputs | jq --raw-output 'keys[]' | tr '\n' ' '); do echo "input_$(echo ${KEY} | tr '[:upper:]' '[:lower:]')=$(cat .inputs | jq --raw-output '.'${KEY}'')" >> $GITHUB_ENV; done
+          rm -rf .inputs
 
       - name: init / .json to env
         uses: rgarcia-phi/json-to-variables@9835d537368468c4e4de5254dc3efeadda183793
@@ -193,12 +202,71 @@ jobs:
           tags: |
             ${{ env.IMAGE_TAGS }}
 
-      - name: github / create release notes
-        if: env.WORKFLOW_GITHUB_RELEASE == 'true' && hashFiles('RELEASE.md') != ''
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      - name: github / release / log
+        id: git-log
         run: |
-          gh release create ${{ github.ref_name }} -F RELEASE.md
+          LOCAL_LAST_TAG=$(git describe --abbrev=0 --tags `git rev-list --tags --skip=1 --max-count=1`)
+          echo "using last tag: ${LOCAL_LAST_TAG}"
+          LOCAL_COMMITS=$(git log ${LOCAL_LAST_TAG}..HEAD --oneline)
+
+          EOF=$(dd if=/dev/urandom bs=15 count=1 status=none | base64)
+          echo "commits<<${EOF}" >> ${GITHUB_OUTPUT}
+          echo "${LOCAL_COMMITS}" >> ${GITHUB_OUTPUT}
+          echo "${EOF}" >> ${GITHUB_OUTPUT}
+
+      - name: github / release / markdown
+        if: env.WORKFLOW_GITHUB_RELEASE == 'true'
+        id: git-release
+        uses: 11notes/action-docker-release@v1
+        with:
+          git_log: ${{ steps.git-log.outputs.commits }}
+
+      - name: github / release / create
+        if: env.WORKFLOW_GITHUB_RELEASE == 'true' && steps.git-release.outcome == 'success'
+        uses: actions/create-release@4c11c9fe1dcd9636620a16455165783b20fc7ea0
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          tag_name: ${{ github.ref }}
+          release_name: ${{ github.ref }}
+          body: ${{ steps.git-release.outputs.release }}
+          draft: false
+          prerelease: false
+
+      - name: github / checkout master
+        continue-on-error: true
+        run: |         
+          git checkout master
+
+      - name: github / create README.md
+        continue-on-error: true
+        if: env.WORKFLOW_GITHUB_README == 'true'
+        id: github-readme
+        uses: 11notes/action-docker-readme@v1
+        with:
+          sarif_file: ${{ steps.grype-scan.outputs.sarif }}
+
+      - name: github / commit & push
+        continue-on-error: true
+        if: steps.github-readme.outcome == 'success'
+        run: |         
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add README.md
+          git commit -m "auto update README.md"
+          git push
+
+      - name: docker / push README.md to docker hub
+        if: hashFiles('README.md') != ''
+        uses: christian-korneck/update-container-description-action@d36005551adeaba9698d8d67a296bd16fa91f8e8
+        env:
+          DOCKER_USER: 11notes
+          DOCKER_PASS: ${{ secrets.DOCKER_TOKEN }}
+        with:
+          destination_container_repo: ${{ env.IMAGE }}
+          provider: dockerhub
+          short_description: ${{ env.json_readme_description }}
+          readme_file: 'README.md'
 
       - name: github / update description and set repo defaults
         run: |
@@ -214,32 +282,4 @@ jobs:
               "has_projects":false,
               "has_wiki":false
             }' \
-            --fail
-
-      - name: github / create README.md
-        if: env.WORKFLOW_GITHUB_README == 'true'
-        id: github-readme
-        uses: 11notes/action-docker-readme@v1.1.2
-        with:
-          sarif_file: ${{ steps.grype-scan.outputs.sarif }}
-
-      - name: github / commit & push
-        if: steps.github-readme.outcome == 'success'
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
-          git add .
-          git commit -m "update README.md"
-          git push
-
-      - name: docker / push README.md to docker hub
-        if: hashFiles('README.md') != ''
-        uses: christian-korneck/update-container-description-action@d36005551adeaba9698d8d67a296bd16fa91f8e8
-        env:
-          DOCKER_USER: 11notes
-          DOCKER_PASS: ${{ secrets.DOCKER_TOKEN }}
-        with:
-          destination_container_repo: ${{ env.IMAGE }}
-          provider: dockerhub
-          short_description: ${{ env.json_readme_description }}
-          readme_file: 'README.md'
+            --fail

.github/workflows/tags.yml

@@ -22,7 +22,7 @@ jobs:
         with:
           workflow: docker.yml
           token: "${{ secrets.REPOSITORY_TOKEN }}"
-          inputs: '{ "release":"false", "readme":"false", "uid":"99", "gid":"100", "semversuffix":"unraid" }'
+          inputs: '{ "release":"false", "readme":"false", "uid":"99", "gid":"100", "semversuffix":"unraid", "run-name":"docker-unraid" }'
 
   kms-gui:
     runs-on: ubuntu-latest
@@ -48,4 +48,4 @@ jobs:
           token: "${{ secrets.REPOSITORY_TOKEN }}"
           repo: 11notes/docker-kms-gui
           ref: master
-          inputs: '{ "release":"false", "readme":"false", "uid":"99", "gid":"100", "semversuffix":"unraid" }'
+          inputs: '{ "release":"false", "readme":"false", "uid":"99", "gid":"100", "semversuffix":"unraid", "run-name":"docker-unraid" }'

.gitignore

@@ -1 +1,3 @@
-maintain/
+# default
+maintain/
+node_modules/

README.md

@@ -0,0 +1,144 @@
+![banner](https://github.com/11notes/defaults/blob/main/static/img/banner.png?raw=true)
+
+# ⛰️ kms
+[<img src="https://img.shields.io/badge/github-source-blue?logo=github&color=040308">](https://github.com/11notes/docker-kms)![size](https://img.shields.io/docker/image-size/11notes/kms/465f4d1?color=0eb305)![version](https://img.shields.io/docker/v/11notes/kms/465f4d1?color=eb7a09)![pulls](https://img.shields.io/docker/pulls/11notes/kms?color=2b75d6)[<img src="https://img.shields.io/github/issues/11notes/docker-kms?color=7842f5">](https://github.com/11notes/docker-kms/issues)
+
+Activate any version of Windows and Office, forever
+
+# MAIN TAGS 🏷️
+These are the main tags for the image. There is also a tag for each commit and its shorthand sha256 value.
+
+* [465f4d1](https://hub.docker.com/r/11notes/kms/tags?name=465f4d1)
+* [stable](https://hub.docker.com/r/11notes/kms/tags?name=stable)
+* [latest](https://hub.docker.com/r/11notes/kms/tags?name=latest)
+* [465f4d1-unraid](https://hub.docker.com/r/11notes/kms/tags?name=465f4d1-unraid)
+* [stable-unraid](https://hub.docker.com/r/11notes/kms/tags?name=stable-unraid)
+* [latest-unraid](https://hub.docker.com/r/11notes/kms/tags?name=latest-unraid)
+
+# UNRAID VERSION 🟠
+This image supports unraid by default. Simply add **-unraid** to any tag and the image will run as 99:100 instead of 1000:1000 causing no issues on unraid. Enjoy.
+
+![Windows Server 2025](https://github.com/11notes/docker-kms/blob/master/img/WindowsSRV2025.png?raw=true)
+
+![Web GUI](https://github.com/11notes/docker-kms/blob/master/img/webGUICustomIcon.png?raw=true)
+
+# SYNOPSIS 📖
+**What can I do with this?** This image will run a KMS server you can use to activate any version of Windows and Office, forever.
+
+Works with:
+- Windows Vista 
+- Windows 7 
+- Windows 8
+- Windows 8.1
+- Windows 10
+- Windows 11
+- Windows Server 2008
+- Windows Server 2008 R2
+- Windows Server 2012
+- Windows Server 2012 R2
+- Windows Server 2016
+- Windows Server 2019
+- Windows Server 2022
+- Windows Server 2025
+- Microsoft Office 2010 ( Volume License )
+- Microsoft Office 2013 ( Volume License )
+- Microsoft Office 2016 ( Volume License )
+- Microsoft Office 2019 ( Volume License )
+- Microsoft Office 2021 ( Volume License )
+- Microsoft Office 2024 ( Volume License )
+
+# VOLUMES 📁
+* **/kms/var** - Directory of the activation database
+
+# COMPOSE ✂️
+```yaml
+name: "kms"
+services:
+  kms:
+    image: "11notes/kms:465f4d1"
+    container_name: "kms"
+    environment:
+      TZ: "Europe/Zurich"
+    volumes:
+      - "var:/kms/var"
+    ports:
+      - "1688:1688/tcp"
+    restart: "always"
+  kms-gui:
+    image: "11notes/kms-gui:stable"
+    container_name: "kms-gui"
+    environment:
+      TZ: "Europe/Zurich"
+    volumes:
+      - "var:/kms/var"
+    ports:
+      - "8080:8080/tcp"
+    restart: "always"
+volumes:
+  var:
+```
+
+# EXAMPLE
+## Windows Server 2025 Datacenter. List of [GVLK](https://learn.microsoft.com/en-us/windows-server/get-started/kms-client-activation-keys)
+```cmd
+slmgr /ipk D764K-2NDRG-47T6Q-P8T8W-YP6DF
+```
+Add your KMS server information to server via registry
+```powershell
+Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\SoftwareProtectionPlatform" -Name "KeyManagementServiceName" -Value "KMS_IP"
+Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\SoftwareProtectionPlatform" -Name "KeyManagementServicePort" -Value "KMS_PORT"
+
+Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\OfficeSoftwareProtectionPlatform" -Name "KeyManagementServiceName" -Value "KMS_IP"
+Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\OfficeSoftwareProtectionPlatform" -Name "KeyManagementServicePort" -Value "KMS_PORT"
+```
+Activate server
+```cmd
+slmgr /ato
+```
+
+# DEFAULT SETTINGS 🗃️
+| Parameter | Value | Description |
+| --- | --- | --- |
+| `user` | docker | user name |
+| `uid` | 1000 | [user identifier](https://en.wikipedia.org/wiki/User_identifier) |
+| `gid` | 1000 | [group identifier](https://en.wikipedia.org/wiki/Group_identifier) |
+| `home` | /kms | home directory of user docker |
+| `database` | /kms/var/kms.db | SQlite database holding all client data |
+
+# ENVIRONMENT 📝
+| Parameter | Value | Default |
+| --- | --- | --- |
+| `TZ` | [Time Zone](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) | |
+| `DEBUG` | Will activate debug option for container image and app (if available) | |
+| `KMS_LOCALE` | see Microsoft LICD specification | 1033 (en-US) |
+| `KMS_CLIENTCOUNT` | client count > 25 | 26 |
+| `KMS_ACTIVATIONINTERVAL` | Retry unsuccessful after N minutes | 120 (2 hours) |
+| `KMS_RENEWALINTERVAL` | re-activation after N minutes | 259200 (180 days) |
+| `KMS_LOGLEVEL` | CRITICAL, ERROR, WARNING, INFO, DEBUG, MININFO | INFO |
+
+# SOURCE 💾
+* [11notes/kms](https://github.com/11notes/docker-kms)
+
+# PARENT IMAGE 🏛️
+* [11notes/alpine:stable](https://hub.docker.com/r/11notes/alpine)
+
+# BUILT WITH 🧰
+* [py-kms](https://github.com/Py-KMS-Organization/py-kms)
+
+# GENERAL TIPS 📌
+* Use a reverse proxy like Traefik, Nginx, HAproxy to terminate TLS and to protect your endpoints
+* Use Let’s Encrypt DNS-01 challenge to obtain valid SSL certificates for your services
+* Do not expose this image to WAN! You will get notified from Microsoft via your ISP to terminate the service if you do so
+* [Microsoft LICD](https://learn.microsoft.com/en-us/openspecs/office_standards/ms-oe376/6c085406-a698-4e12-9d4d-c3b0ee3dbc4a)
+* Use [11notes/kms-gui](https://github.com/11notes/docker-kms-gui) if you want to see the clients you activated in a nice web GUI
+
+# SECURITY VULNERABILITIES REPORT ⚡
+| Severity | Package | Version | Fix Version | Type | Location | Data Namespace | Link |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| 4.7 (Medium) | linux-pam  | 1.6.1-r1  |   | apk  | /lib/apk/db/installed  | nvd:cpe  | [CVE-2024-10041](https://nvd.nist.gov/vuln/detail/CVE-2024-10041)  |
+
+
+# ElevenNotes™️
+This image is provided to you at your own risk. Always make backups before updating an image to a different version. Check the [releases](https://github.com/11notes/docker-kms/releases) for breaking changes. If you have any problems with using this image simply raise an [issue](https://github.com/11notes/docker-kms/issues), thanks. If you have a question or inputs please create a new [discussion](https://github.com/11notes/docker-kms/discussions) instead of an issue. You can find all my other repositories on [github](https://github.com/11notes?tab=repositories).
+
+*created Wed, 19 Feb 2025 10:09:40 GMT*

RELEASE.md

@@ -1,4 +0,0 @@
-### 🪄 Features
-* add healthcheck directly to build (no script)
-* add Office activation screenshot
-* add custom 11notes/action-sarif-to-markdown@v1.1.0 for sarif to markdown (future use) to workflow

rootfs/opt/py-kms/pykms_Base.py

@@ -0,0 +1,268 @@
+#!/usr/bin/env python3
+
+import binascii
+import logging
+import time
+import uuid
+
+from pykms_Structure import Structure
+from pykms_DB2Dict import kmsDB2Dict
+from pykms_PidGenerator import epidGenerator
+from pykms_Filetimes import filetime_to_dt
+from pykms_Sql import sql_update, sql_update_epid
+from pykms_Format import justify, byterize, enco, deco, pretty_printer
+
+#--------------------------------------------------------------------------------------------------------------------------------------------------------
+
+loggersrv = logging.getLogger('logsrv')
+
+class UUID(Structure):
+        commonHdr = ()
+        structure = (
+                ('raw', '16s'),
+        )
+
+        def get(self):
+                return uuid.UUID(bytes_le = enco(str(self), 'latin-1'))
+
+class kmsBase:
+        def __init__(self, data, srv_config):
+                self.data = data
+                self.srv_config = srv_config
+                
+        class kmsRequestStruct(Structure):
+                commonHdr = ()
+                structure = (
+                        ('versionMinor',            '<H'),
+                        ('versionMajor',            '<H'),
+                        ('isClientVm',              '<I'),
+                        ('licenseStatus',           '<I'),
+                        ('graceTime',               '<I'),
+                        ('applicationId',           ':', UUID),
+                        ('skuId',                   ':', UUID),
+                        ('kmsCountedId' ,           ':', UUID),
+                        ('clientMachineId',         ':', UUID),
+                        ('requiredClientCount',     '<I'),
+                        ('requestTime',             '<Q'),
+                        ('previousClientMachineId', ':', UUID),
+                        ('machineName',             'u'),
+                        ('_mnPad',                  '_-mnPad', '126-len(machineName)'),
+                        ('mnPad',                   ':'),
+                )
+
+                def getMachineName(self):
+                        return self['machineName'].decode('utf-16le')
+                
+                def getLicenseStatus(self):
+                        return kmsBase.licenseStates[self['licenseStatus']] or "Unknown"
+
+        class kmsResponseStruct(Structure):
+                commonHdr = ()
+                structure = (
+                        ('versionMinor',         '<H'),
+                        ('versionMajor',         '<H'),
+                        ('epidLen',              '<I=len(kmsEpid)+2'),
+                        ('kmsEpid',              'u'),
+                        ('clientMachineId',      ':', UUID),
+                        ('responseTime',         '<Q'),
+                        ('currentClientCount',   '<I'),
+                        ('vLActivationInterval', '<I'),
+                        ('vLRenewalInterval',    '<I'),
+                )
+
+        class GenericRequestHeader(Structure):
+                commonHdr = ()
+                structure = (
+                        ('bodyLength1',  '<I'),
+                        ('bodyLength2',  '<I'),
+                        ('versionMinor', '<H'),
+                        ('versionMajor', '<H'),
+                        ('remainder',    '_'),
+                )
+
+        licenseStates = {
+                0 : "Unlicensed",
+                1 : "Activated",
+                2 : "Grace Period",
+                3 : "Out-of-Tolerance Grace Period",
+                4 : "Non-Genuine Grace Period",
+                5 : "Notifications Mode",
+                6 : "Extended Grace Period",
+        }
+
+        licenseStatesEnum = {
+                'unlicensed' : 0,
+                'licensed' : 1,
+                'oobGrace' : 2,
+                'ootGrace' : 3,
+                'nonGenuineGrace' : 4,
+                'notification' : 5,
+                'extendedGrace' : 6
+        }
+
+        
+        def getPadding(self, bodyLength):
+                ## https://forums.mydigitallife.info/threads/71213-Source-C-KMS-Server-from-Microsoft-Toolkit?p=1277542&viewfull=1#post1277542
+                return 4 + (((~bodyLength & 3) + 1) & 3)
+
+        def serverLogic(self, kmsRequest):
+                pretty_printer(num_text = 15, where = "srv")
+                kmsRequest = byterize(kmsRequest)
+                loggersrv.debug("KMS Request Bytes: \n%s\n" % justify(deco(binascii.b2a_hex(enco(str(kmsRequest), 'latin-1')), 'latin-1')))                         
+                loggersrv.debug("KMS Request: \n%s\n" % justify(kmsRequest.dump(print_to_stdout = False)))
+                                        
+                clientMachineId = kmsRequest['clientMachineId'].get()
+                applicationId = kmsRequest['applicationId'].get()
+                skuId = kmsRequest['skuId'].get()
+                requestDatetime = filetime_to_dt(kmsRequest['requestTime'])
+                                
+                # Localize the request time, if module "tzlocal" is available.
+                try:
+                        from datetime import datetime
+                        from tzlocal import get_localzone
+                        from pytz.exceptions import UnknownTimeZoneError
+                        try:
+                                local_dt = datetime.fromisoformat(str(requestDatetime)).astimezone(get_localzone())
+                        except UnknownTimeZoneError:
+                                pretty_printer(log_obj = loggersrv.warning,
+                                               put_text = "{reverse}{yellow}{bold}Unknown time zone ! Request time not localized.{end}")
+                                local_dt = requestDatetime
+                except ImportError:
+                        pretty_printer(log_obj = loggersrv.warning,
+                                       put_text = "{reverse}{yellow}{bold}Module 'tzlocal' or 'pytz' not available ! Request time not localized.{end}")
+                        local_dt = requestDatetime
+                except Exception as e:
+                    # Just in case something else goes wrong
+                    loggersrv.warning('Okay, something went horribly wrong while localizing the request time (proceeding anyways): ' + str(e))
+                    local_dt = requestDatetime
+                    pass
+
+                # Activation threshold.
+                # https://docs.microsoft.com/en-us/windows/deployment/volume-activation/activate-windows-10-clients-vamt                
+                MinClients = kmsRequest['requiredClientCount'] 
+                RequiredClients = MinClients * 2
+                if self.srv_config["clientcount"] != None:
+                        if 0 < self.srv_config["clientcount"] < MinClients:
+                                # fixed to 6 (product server) or 26 (product desktop)
+                                currentClientCount = MinClients + 1
+                                pretty_printer(log_obj = loggersrv.warning,
+                                               put_text = "{reverse}{yellow}{bold}Not enough clients ! Fixed with %s, but activated client \
+could be detected as not genuine !{end}" %currentClientCount)
+                        elif MinClients <= self.srv_config["clientcount"] < RequiredClients:
+                                currentClientCount = self.srv_config["clientcount"]
+                                pretty_printer(log_obj = loggersrv.warning,
+                                               put_text = "{reverse}{yellow}{bold}With count = %s, activated client could be detected as not genuine !{end}" %currentClientCount)
+                        elif self.srv_config["clientcount"] >= RequiredClients:
+                                # fixed to 10 (product server) or 50 (product desktop)
+                                currentClientCount = RequiredClients
+                                if self.srv_config["clientcount"] > RequiredClients:
+                                        pretty_printer(log_obj = loggersrv.warning,
+                                                       put_text = "{reverse}{yellow}{bold}Too many clients ! Fixed with %s{end}" %currentClientCount)
+                else:
+                        # fixed to 10 (product server) or 50 (product desktop)
+                        currentClientCount = RequiredClients     
+
+                        
+                # Get a name for SkuId, AppId.        
+                kmsdb = kmsDB2Dict()
+                appName, skuName = str(applicationId), str(skuId)
+ 
+                appitems = kmsdb[2]
+                for appitem in appitems:
+                        kmsitems = appitem['KmsItems']
+                        for kmsitem in kmsitems:                                       
+                                skuitems = kmsitem['SkuItems']
+                                for skuitem in skuitems:
+                                        try:
+                                                if uuid.UUID(skuitem['Id']) == skuId:
+                                                        skuName = skuitem['DisplayName']
+                                                        break
+                                        except:
+                                                skuName = skuId
+                                                pretty_printer(log_obj = loggersrv.warning,
+                                                               put_text = "{reverse}{yellow}{bold}Can't find a name for this product !{end}")
+                                    
+                        try:
+                                if uuid.UUID(appitem['Id']) == applicationId:
+                                        appName = appitem['DisplayName']
+                        except:
+                                appName = applicationId
+                                pretty_printer(log_obj = loggersrv.warning,
+                                               put_text = "{reverse}{yellow}{bold}Can't find a name for this application group !{end}")
+
+                infoDict = {
+                        "machineName" : kmsRequest.getMachineName(),
+                        "clientMachineId" : str(clientMachineId),
+                        "appId" : appName,
+                        "skuId" : skuName,
+                        "licenseStatus" : kmsRequest.getLicenseStatus(),
+                        "requestTime" : int(time.time()),
+                        "kmsEpid" : None,
+                        "machineIp"  : self.srv_config['raddr']
+                }
+
+                loggersrv.info("Machine Name: %s" % infoDict["machineName"])
+                loggersrv.info("Machine IP: %s" % infoDict["machineIp"])
+                loggersrv.info("Client Machine ID: %s" % infoDict["clientMachineId"])
+                loggersrv.info("Application ID: %s" % infoDict["appId"])
+                loggersrv.info("SKU ID: %s" % infoDict["skuId"])
+                loggersrv.info("License Status: %s" % infoDict["licenseStatus"])
+                loggersrv.info("Request Time: %s" % local_dt.strftime('%Y-%m-%d %H:%M:%S %Z (UTC%z)'))
+                
+                if self.srv_config['loglevel'] == 'MININFO':
+                        loggersrv.mininfo("", extra = {'host': self.srv_config['raddr'],
+                                                       'status' : infoDict["licenseStatus"],
+                                                       'product' : infoDict["skuId"]})
+                # Create database.
+                if self.srv_config['sqlite']:
+                        sql_update(self.srv_config['sqlite'], infoDict)
+
+                return self.createKmsResponse(kmsRequest, currentClientCount, appName)
+
+        def createKmsResponse(self, kmsRequest, currentClientCount, appName):
+                response = self.kmsResponseStruct()
+                response['versionMinor'] = kmsRequest['versionMinor']
+                response['versionMajor'] = kmsRequest['versionMajor']
+                
+                if not self.srv_config["epid"]:
+                        response["kmsEpid"] = epidGenerator(kmsRequest['kmsCountedId'].get(), kmsRequest['versionMajor'],
+                                                            self.srv_config["lcid"]).encode('utf-16le')
+                else:
+                        response["kmsEpid"] = self.srv_config["epid"].encode('utf-16le')
+
+                response['clientMachineId'] = kmsRequest['clientMachineId']
+                # rule: timeserver - 4h <= timeclient <= timeserver + 4h, check if is satisfied (TODO).
+                response['responseTime'] = kmsRequest['requestTime']
+                response['currentClientCount'] = currentClientCount
+                response['vLActivationInterval'] = self.srv_config["activation"]
+                response['vLRenewalInterval'] = self.srv_config["renewal"]
+
+                # Update database epid.
+                if self.srv_config['sqlite']:
+                        sql_update_epid(self.srv_config['sqlite'], kmsRequest, response, appName)
+
+                loggersrv.info("Server ePID: %s" % response["kmsEpid"].decode('utf-16le'))
+                        
+                return response
+
+
+import pykms_RequestV4, pykms_RequestV5, pykms_RequestV6, pykms_RequestUnknown
+
+def generateKmsResponseData(data, srv_config):
+        version = kmsBase.GenericRequestHeader(data)['versionMajor']
+        currentDate = time.strftime("%a %b %d %H:%M:%S %Y")
+
+        if version == 4:
+                loggersrv.info("Received V%d request on %s." % (version, currentDate))
+                messagehandler = pykms_RequestV4.kmsRequestV4(data, srv_config)     
+        elif version == 5:
+                loggersrv.info("Received V%d request on %s." % (version, currentDate))
+                messagehandler = pykms_RequestV5.kmsRequestV5(data, srv_config)
+        elif version == 6:
+                loggersrv.info("Received V%d request on %s." % (version, currentDate))
+                messagehandler = pykms_RequestV6.kmsRequestV6(data, srv_config)
+        else:
+                loggersrv.info("Unhandled KMS version V%d." % version)
+                messagehandler = pykms_RequestUnknown.kmsRequestUnknown(data, srv_config)
+                
+        return messagehandler.executeRequestLogic()

rootfs/opt/py-kms/pykms_Server.py

@@ -0,0 +1,545 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+import binascii
+import re
+import sys
+import socket
+import uuid
+import logging
+import os
+import threading
+import socketserver
+import queue as Queue
+import selectors
+from time import monotonic as time
+
+import pykms_RpcBind, pykms_RpcRequest
+from pykms_RpcBase import rpcBase
+from pykms_Dcerpc import MSRPCHeader
+from pykms_Misc import check_setup, check_lcid, check_other
+from pykms_Misc import KmsParser, KmsParserException, KmsParserHelp
+from pykms_Misc import kms_parser_get, kms_parser_check_optionals, kms_parser_check_positionals, kms_parser_check_connect
+from pykms_Format import enco, deco, pretty_printer, justify
+from pykms_Connect import MultipleListener
+from pykms_Sql import sql_initialize
+
+srv_version             = "py-kms_2020-10-01"
+__license__             = "The Unlicense"
+__author__              = u"Matteo ℱan <SystemRage@protonmail.com>"
+__url__                 = "https://github.com/SystemRage/py-kms"
+srv_description         = "py-kms: KMS Server Emulator written in Python"
+srv_config = {}
+
+##---------------------------------------------------------------------------------------------------------------------------------------------------------
+class KeyServer(socketserver.ThreadingMixIn, socketserver.TCPServer):
+        daemon_threads = True
+
+        def __init__(self, server_address, RequestHandlerClass, bind_and_activate = True, want_dual = False):
+                socketserver.BaseServer.__init__(self, server_address, RequestHandlerClass)
+                self.__shutdown_request = False
+                self.r_service, self.w_service = socket.socketpair()
+
+                if hasattr(selectors, 'PollSelector'):
+                        self._ServerSelector = selectors.PollSelector
+                else:
+                        self._ServerSelector = selectors.SelectSelector
+
+                if bind_and_activate:
+                        try:
+                                self.multisock = MultipleListener(server_address, want_dual = want_dual)
+                        except Exception as e:
+                                if want_dual and str(e) == "dualstack_ipv6 not supported on this platform":
+                                        try:
+                                                pretty_printer(log_obj = loggersrv.warning,
+                                                               put_text = "{reverse}{yellow}{bold}%s. Creating not dualstack sockets...{end}" %str(e))
+                                                self.multisock = MultipleListener(server_address, want_dual = False)
+                                        except Exception as e:
+                                                pretty_printer(log_obj = loggersrv.error, to_exit = True,
+                                                               put_text = "{reverse}{red}{bold}%s. Exiting...{end}" %str(e))
+                                else:
+                                        pretty_printer(log_obj = loggersrv.error, to_exit = True,
+                                                       put_text = "{reverse}{red}{bold}%s. Exiting...{end}" %str(e))
+
+                        if self.multisock.cant_dual:
+                                delim = ('' if len(self.multisock.cant_dual) == 1 else ', ')
+                                pretty_printer(log_obj = loggersrv.warning,
+                                               put_text = "{reverse}{yellow}{bold}IPv4 [%s] can't be dualstack{end}" %delim.join(self.multisock.cant_dual))
+
+
+        def pykms_serve(self):
+                """ Mixing of socketserver serve_forever() and handle_request() functions,
+                    without elements blocking tkinter.
+                    Handle one request at a time, possibly blocking.
+                    Respects self.timeout.
+                """
+                # Support people who used socket.settimeout() to escape
+                # pykms_serve() before self.timeout was available.
+                timeout = self.multisock.gettimeout()
+                if timeout is None:
+                        timeout = self.timeout
+                elif self.timeout is not None:
+                        timeout = min(timeout, self.timeout)
+                if timeout is not None:
+                        deadline = time() + timeout
+
+                try:
+                        # Wait until a request arrives or the timeout expires.
+                        with self._ServerSelector() as selector:
+                                self.multisock.register(selector)
+                                # self-pipe trick.
+                                selector.register(fileobj = self.r_service.fileno(), events = selectors.EVENT_READ)
+
+                                while not self.__shutdown_request:
+                                        ready = selector.select(timeout)
+                                        if self.__shutdown_request:
+                                                break
+
+                                        if ready == []:
+                                                if timeout is not None:
+                                                        timeout = deadline - time()
+                                                        if timeout < 0:
+                                                                return self.handle_timeout()
+                                        else:
+                                                for key, mask in ready:
+                                                        if key.fileobj in self.multisock.filenos():
+                                                                self.socket = self.multisock.sockmap[key.fileobj]
+                                                                self.server_address = self.socket.getsockname()
+                                                                self._handle_request_noblock()
+                                                        elif key.fileobj is self.r_service.fileno():
+                                                                # only to clean buffer.
+                                                                msgkill = os.read(self.r_service.fileno(), 8).decode('utf-8')
+                                                                sys.exit(0)
+                finally:
+                        self.__shutdown_request = False
+
+        def shutdown(self):
+                self.__shutdown_request = True
+
+        def server_close(self):
+                self.multisock.close()
+
+        def handle_timeout(self):
+                pretty_printer(log_obj = loggersrv.error, to_exit = True,
+                               put_text = "{reverse}{red}{bold}Server connection timed out. Exiting...{end}")
+
+        def handle_error(self, request, client_address):
+                pass
+
+
+class server_thread(threading.Thread):
+        def __init__(self, queue, name):
+                threading.Thread.__init__(self)
+                self.name = name
+                self.queue = queue
+                self.server = None
+                self.is_running_server = False
+                self.checked = False
+                self.is_running_thread = threading.Event()
+
+        def terminate_serve(self):
+                self.server.shutdown()
+                self.server.server_close()
+                self.server = None
+                self.is_running_server = False
+
+        def terminate_thread(self):
+                self.is_running_thread.set()
+
+        def terminate_eject(self):
+                os.write(self.server.w_service.fileno(), u'☠'.encode('utf-8'))
+
+        def run(self):
+                while not self.is_running_thread.is_set():
+                        try:
+                                item = self.queue.get(block = True, timeout = 0.1)
+                                self.queue.task_done()
+                        except Queue.Empty:
+                                continue
+                        else:
+                                try:
+                                        if item == 'start':
+                                                self.eject = False
+                                                self.is_running_server = True
+                                                # Check options.
+                                                if not self.checked:
+                                                        server_check()
+                                                # Create and run server.
+                                                self.server = server_create()
+                                                self.server.pykms_serve()
+                                except (SystemExit, Exception) as e:
+                                        self.eject = True
+                                        raise
+
+##---------------------------------------------------------------------------------------------------------------------------------------------------------
+
+loggersrv = logging.getLogger('logsrv')
+
+def _str2bool(v):
+    if isinstance(v, bool):
+        return v
+    if v.lower() in ('yes', 'true', 't', 'y', '1'):
+        return True
+    elif v.lower() in ('no', 'false', 'f', 'n', '0'):
+        return False
+    else:
+        raise ValueError('Boolean value expected.')
+
+# 'help' string - 'default' value - 'dest' string.
+srv_options = {
+        'ip'         : {'help' : 'The IP address (IPv4 or IPv6) to listen on. The default is \"::\" (all interfaces).', 'def' : "::", 'des' : "ip"},
+        'port'       : {'help' : 'The network port to listen on. The default is \"1688\".', 'def' : 1688, 'des' : "port"},
+        'epid'       : {'help' : 'Use this option to manually specify an ePID to use. If no ePID is specified, a random ePID will be auto generated.',
+                        'def' : None, 'des' : "epid"},
+        'lcid'       : {'help' : 'Use this option to manually specify an LCID for use with randomly generated ePIDs. Default is \"1033\" (en-us)',
+                        'def' : 1033, 'des' : "lcid"},
+        'count'      : {'help' : 'Use this option to specify the current client count. A number >=25 is required to enable activation of client OSes; \
+for server OSes and Office >=5', 'def' : None, 'des' : "clientcount"},
+        'activation' : {'help' : 'Use this option to specify the activation interval (in minutes). Default is \"120\" minutes (2 hours).',
+                        'def' : 120, 'des': "activation"},
+        'renewal'    : {'help' : 'Use this option to specify the renewal interval (in minutes). Default is \"10080\" minutes (7 days).',
+                        'def' : 1440 * 7, 'des' : "renewal"},
+        'sql'        : {'help' : 'Use this option to store request information from unique clients in an SQLite database. Deactivated by default.', 'def' : False,
+                        'file': os.path.join('.', 'pykms_database.db'), 'des' : "sqlite"},
+        'hwid'       : {'help' : 'Use this option to specify a HWID. The HWID must be an 16-character string of hex characters. \
+Type \"RANDOM\" to auto-generate the HWID.',
+                        'def' : "RANDOM", 'des' : "hwid"},
+        'time0'      : {'help' : 'Maximum inactivity time (in seconds) after which the connection with the client is closed. If \"None\" (default) serve forever.',
+                        'def' : None, 'des' : "timeoutidle"},
+        'time1'      : {'help' : 'Set the maximum time to wait for sending / receiving a request / response. Default is no timeout.',
+                        'def' : None, 'des' : "timeoutsndrcv"},
+        'asyncmsg'   : {'help' : 'Prints pretty / logging messages asynchronously. Deactivated by default.',
+                        'def' : False, 'des' : "asyncmsg"},
+        'llevel'     : {'help' : 'Use this option to set a log level. The default is \"WARNING\".', 'def' : "WARNING", 'des' : "loglevel",
+                        'choi' : ["CRITICAL", "ERROR", "WARNING", "INFO", "DEBUG", "MININFO"]},
+        'lfile'      : {'help' : 'Use this option to set an output log file. The default is \"pykms_logserver.log\". \
+Type \"STDOUT\" to view log info on stdout. Type \"FILESTDOUT\" to combine previous actions. \
+Use \"STDOUTOFF\" to disable stdout messages. Use \"FILEOFF\" if you not want to create logfile.',
+                        'def' : os.path.join('.', 'pykms_logserver.log'), 'des' : "logfile"},
+        'lsize'      : {'help' : 'Use this flag to set a maximum size (in MB) to the output log file. Deactivated by default.', 'def' : 0, 'des': "logsize"},
+        'listen'     : {'help' : 'Adds multiple listening ip address - port couples.', 'des': "listen"},
+        'backlog'    : {'help' : 'Specifies the maximum length of the queue of pending connections. Default is \"5\".', 'def' : 5, 'des': "backlog"},
+        'reuse'      : {'help' : 'Do not allows binding / listening to the same address and port. Reusing port is activated by default.', 'def' : True,
+                        'des': "reuse"},
+        'dual'       : {'help' : 'Allows listening to an IPv6 address while also accepting connections via IPv4. If used, it refers to all addresses (main and additional). Activated by default. Pass in "false" or "true" to disable or enable.',
+                        'def' : True, 'des': "dual"}
+        }
+
+def server_options():
+        server_parser = KmsParser(description = srv_description, epilog = 'version: ' + srv_version, add_help = False)
+        server_parser.add_argument("ip", nargs = "?", action = "store", default = srv_options['ip']['def'], help = srv_options['ip']['help'], type = str)
+        server_parser.add_argument("port", nargs = "?", action = "store", default = srv_options['port']['def'], help = srv_options['port']['help'], type = int)
+        server_parser.add_argument("-e", "--epid", action = "store", dest = srv_options['epid']['des'], default = srv_options['epid']['def'],
+                                   help = srv_options['epid']['help'], type = str)
+        server_parser.add_argument("-l", "--lcid", action = "store", dest = srv_options['lcid']['des'], default = srv_options['lcid']['def'],
+                                   help = srv_options['lcid']['help'], type = int)
+        server_parser.add_argument("-c", "--client-count", action = "store", dest = srv_options['count']['des'] , default = srv_options['count']['def'],
+                                   help = srv_options['count']['help'], type = str)
+        server_parser.add_argument("-a", "--activation-interval", action = "store", dest = srv_options['activation']['des'],
+                                   default = srv_options['activation']['def'], help = srv_options['activation']['help'], type = int)
+        server_parser.add_argument("-r", "--renewal-interval", action = "store", dest = srv_options['renewal']['des'],
+                                   default = srv_options['renewal']['def'], help = srv_options['renewal']['help'], type = int)
+        server_parser.add_argument("-s", "--sqlite", nargs = "?", dest = srv_options['sql']['des'], const = True,
+                                   default = srv_options['sql']['def'], help = srv_options['sql']['help'], type = str)
+        server_parser.add_argument("-w", "--hwid", action = "store", dest = srv_options['hwid']['des'], default = srv_options['hwid']['def'],
+                                   help = srv_options['hwid']['help'], type = str)
+        server_parser.add_argument("-t0", "--timeout-idle", action = "store", dest = srv_options['time0']['des'], default = srv_options['time0']['def'],
+                                   help = srv_options['time0']['help'], type = str)
+        server_parser.add_argument("-t1", "--timeout-sndrcv", action = "store", dest = srv_options['time1']['des'], default = srv_options['time1']['def'],
+                                   help = srv_options['time1']['help'], type = str)
+        server_parser.add_argument("-y", "--async-msg", action = "store_true", dest = srv_options['asyncmsg']['des'],
+                                   default = srv_options['asyncmsg']['def'], help = srv_options['asyncmsg']['help'])
+        server_parser.add_argument("-V", "--loglevel", action = "store", dest = srv_options['llevel']['des'], choices = srv_options['llevel']['choi'],
+                                   default = srv_options['llevel']['def'], help = srv_options['llevel']['help'], type = str)
+        server_parser.add_argument("-F", "--logfile", nargs = "+", action = "store", dest = srv_options['lfile']['des'],
+                                   default = srv_options['lfile']['def'], help = srv_options['lfile']['help'], type = str)
+        server_parser.add_argument("-S", "--logsize", action = "store", dest = srv_options['lsize']['des'], default = srv_options['lsize']['def'],
+                                   help = srv_options['lsize']['help'], type = float)
+
+        server_parser.add_argument("-h", "--help", action = "help", help = "show this help message and exit")
+
+        ## Connection parsing.
+        connection_parser = KmsParser(description = "connect options", add_help = False)
+        connection_subparser = connection_parser.add_subparsers(dest = "mode")
+
+        connect_parser = connection_subparser.add_parser("connect", add_help = False)
+        connect_parser.add_argument("-n", "--listen", action = "append", dest = srv_options['listen']['des'], default = [],
+                                    help = srv_options['listen']['help'], type = str)
+        connect_parser.add_argument("-b", "--backlog", action = "append", dest = srv_options['backlog']['des'], default = [],
+                                    help = srv_options['backlog']['help'], type = int)
+        connect_parser.add_argument("-u", "--no-reuse", action = "append_const", dest = srv_options['reuse']['des'], const = False, default = [],
+                                    help = srv_options['reuse']['help'])
+        connect_parser.add_argument("-d", "--dual", type = _str2bool, dest = srv_options['dual']['des'], default = srv_options['dual']['def'],
+                                    help = srv_options['dual']['help'])
+
+        try:
+                userarg = sys.argv[1:]
+
+                # Run help.
+                if any(arg in ["-h", "--help"] for arg in userarg):
+                        KmsParserHelp().printer(parsers = [server_parser, (connection_parser, connect_parser)])
+
+                # Get stored arguments.
+                pykmssrv_zeroarg, pykmssrv_onearg = kms_parser_get(server_parser)
+                connect_zeroarg, connect_onearg = kms_parser_get(connect_parser)
+                subdict = {
+                        'connect' : (connect_zeroarg, connect_onearg, connection_parser.parse_args)
+                }
+                subpars = list(subdict.keys())
+                pykmssrv_zeroarg += subpars # add subparsers
+
+                exclude_kms = ['-F', '--logfile']
+                exclude_dup = ['-n', '--listen', '-b', '--backlog', '-u', '--no-reuse']
+
+                # Set defaults for server dict config.
+                # example case:
+                #       python3 pykms_Server.py
+                srv_config.update(vars(server_parser.parse_args([])))
+
+                subindx = sorted([(userarg.index(pars), pars) for pars in subpars if pars in userarg], key = lambda x: x[0])
+                if subindx:
+                        # Set `daemon options` and/or `connect options` for server dict config.
+                        # example cases:
+                        # 1     python3 pykms_Server.py [1.2.3.4] [1234] [--pykms_optionals] connect [--connect_optionals]
+                        first = subindx[0][0]
+                        # initial.
+                        kms_parser_check_optionals(userarg[0 : first], pykmssrv_zeroarg, pykmssrv_onearg, exclude_opt_len = exclude_kms)
+                        kms_parser_check_positionals(srv_config, server_parser.parse_args, arguments = userarg[0 : first], force_parse = True)
+                        # middle.
+                        for i in range(len(subindx) - 1):
+                                posi, posf, typ = subindx[i][0], subindx[i + 1][0], subindx[i][1]
+                                kms_parser_check_optionals(userarg[posi : posf], subdict[typ][0], subdict[typ][1], msg = 'optional %s' %typ,
+                                                           exclude_opt_dup = (exclude_dup if typ == 'connect' else []))
+                                kms_parser_check_positionals(srv_config, subdict[typ][2], arguments = userarg[posi : posf], msg = 'positional %s' %typ)
+                        # final.
+                        pos, typ = subindx[-1]
+                        kms_parser_check_optionals(userarg[pos:], subdict[typ][0], subdict[typ][1], msg = 'optional %s' %typ,
+                                                   exclude_opt_dup = (exclude_dup if typ == 'connect' else []))
+                        kms_parser_check_positionals(srv_config, subdict[typ][2], arguments = userarg[pos:], msg = 'positional %s' %typ)
+
+                        if len(subindx) > 1:
+                                srv_config['mode'] = '+'.join(elem[1] for elem in subindx)
+                else:
+                        # Update `pykms options` for server dict config.
+                        # example case:
+                        # 2     python3 pykms_Server.py [1.2.3.4] [1234] [--pykms_optionals]
+                        kms_parser_check_optionals(userarg, pykmssrv_zeroarg, pykmssrv_onearg, exclude_opt_len = exclude_kms)
+                        kms_parser_check_positionals(srv_config, server_parser.parse_args)
+
+                kms_parser_check_connect(srv_config, srv_options, userarg, connect_zeroarg, connect_onearg)
+
+        except KmsParserException as e:
+                pretty_printer(put_text = "{reverse}{red}{bold}%s. Exiting...{end}" %str(e), to_exit = True)
+
+def server_check():
+        # Setup and some checks.
+        check_setup(srv_config, srv_options, loggersrv, where = "srv")
+
+        # Random HWID.
+        if srv_config['hwid'] == "RANDOM":
+                randomhwid = uuid.uuid4().hex
+                srv_config['hwid'] = randomhwid[:16]
+           
+        # Sanitize HWID.
+        hexstr = srv_config['hwid']
+        # Strip 0x from the start of hexstr
+        if hexstr.startswith("0x"):
+            hexstr = hexstr[2:]
+
+        hexsub = re.sub(r'[^0-9a-fA-F]', '', hexstr)
+        diff = set(hexstr).symmetric_difference(set(hexsub))
+
+        if len(diff) != 0:
+                diff = str(diff).replace('{', '').replace('}', '')
+                pretty_printer(log_obj = loggersrv.error, to_exit = True,
+                               put_text = "{reverse}{red}{bold}HWID '%s' is invalid. Digit %s non hexadecimal. Exiting...{end}" %(hexstr.upper(), diff))
+        else:
+                lh = len(hexsub)
+                if lh % 2 != 0:
+                        pretty_printer(log_obj = loggersrv.error, to_exit = True,
+                                       put_text = "{reverse}{red}{bold}HWID '%s' is invalid. Hex string is odd length. Exiting...{end}" %hexsub.upper())
+                elif lh < 16:
+                        pretty_printer(log_obj = loggersrv.error, to_exit = True,
+                                       put_text = "{reverse}{red}{bold}HWID '%s' is invalid. Hex string is too short. Exiting...{end}" %hexsub.upper())
+                elif lh > 16:
+                        pretty_printer(log_obj = loggersrv.error, to_exit = True,
+                                       put_text = "{reverse}{red}{bold}HWID '%s' is invalid. Hex string is too long. Exiting...{end}" %hexsub.upper())
+                else:
+                        srv_config['hwid'] = binascii.a2b_hex(hexsub)
+
+        # Check LCID.
+        srv_config['lcid'] = check_lcid(srv_config['lcid'], loggersrv.warning)
+                                
+        # Check sqlite.
+        if srv_config['sqlite']:
+                if srv_config['sqlite'] is True: # Resolve bool to the default path
+                        srv_config['sqlite'] = srv_options['sql']['file']
+                if os.path.isdir(srv_config['sqlite']):
+                        pretty_printer(log_obj = loggersrv.warning,
+                                put_text = "{reverse}{yellow}{bold}You specified a folder instead of a database file! This behavior is not officially supported anymore, please change your start parameters soon.{end}")
+                        srv_config['sqlite'] = os.path.join(srv_config['sqlite'], 'pykms_database.db')
+
+                try:
+                        import sqlite3
+                        sql_initialize(srv_config['sqlite'])
+                except ImportError:
+                        pretty_printer(log_obj = loggersrv.warning,
+                                put_text = "{reverse}{yellow}{bold}Module 'sqlite3' not installed, database support disabled.{end}")
+                        srv_config['sqlite'] = False
+
+        # Check other specific server options.
+        opts = [('clientcount', '-c/--client-count'),
+                ('timeoutidle', '-t0/--timeout-idle'),
+                ('timeoutsndrcv', '-t1/--timeout-sndrcv')]
+        check_other(srv_config, opts, loggersrv, where = 'srv')
+
+        # Check further addresses / ports.
+        if 'listen' in srv_config:
+                addresses = []
+                for elem in srv_config['listen']:
+                        try:
+                                addr, port = elem.split(',')
+                        except ValueError:
+                                pretty_printer(log_obj = loggersrv.error, to_exit = True,
+                                               put_text = "{reverse}{red}{bold}argument `-n/--listen`: %s not well defined. Exiting...{end}" %elem)
+                        try:
+                                port = int(port)
+                        except ValueError:
+                                pretty_printer(log_obj = loggersrv.error, to_exit = True,
+                                               put_text = "{reverse}{red}{bold}argument `-n/--listen`: port number '%s' is invalid. Exiting...{end}" %port)
+
+                        if not (1 <= port <= 65535):
+                                pretty_printer(log_obj = loggersrv.error, to_exit = True,
+                                               put_text = "{reverse}{red}{bold}argument `-n/--listen`: port number '%s' is invalid. Enter between 1 - 65535. Exiting...{end}" %port)
+
+                        addresses.append((addr, port))
+                srv_config['listen'] = addresses
+
+def server_create():
+        # Create address list (when the current user indicates execution inside the Windows Sandbox,
+        # then we wont allow port reuse - it is not supported).
+        all_address = [(
+                        srv_config['ip'], srv_config['port'],
+                        (srv_config['backlog_main'] if 'backlog_main' in srv_config else srv_options['backlog']['def']),
+                        (srv_config['reuse_main'] if 'reuse_main' in srv_config else srv_options['reuse']['def'])
+                        )]
+        log_address = "TCP server listening at %s on port %d" %(srv_config['ip'], srv_config['port'])
+
+        if 'listen' in srv_config:
+                for l, b, r in zip(srv_config['listen'], srv_config['backlog'], srv_config['reuse']):
+                        all_address.append(l + (b,) + (r,))
+                        log_address += justify("at %s on port %d" %(l[0], l[1]), indent = 56)
+
+        server = KeyServer(all_address, kmsServerHandler, want_dual = (srv_config['dual'] if 'dual' in srv_config else srv_options['dual']['def']))
+        server.timeout = srv_config['timeoutidle']
+
+        loggersrv.info(log_address)
+        loggersrv.info("HWID: %s" % deco(binascii.b2a_hex(srv_config['hwid']), 'utf-8').upper())
+
+        return server
+
+def server_terminate(generic_srv, exit_server = False, exit_thread = False):
+        if exit_server:
+                generic_srv.terminate_serve()
+        if exit_thread:
+                generic_srv.terminate_thread()
+
+class ServerWithoutGui(object):
+        def start(self):
+                import queue as Queue
+                daemon_queue = Queue.Queue(maxsize = 0)
+                daemon_serverthread = server_thread(daemon_queue, name = "Thread-Srv-Daemon")
+                daemon_serverthread.setDaemon(True)
+                # options already checked in `server_main_terminal`.
+                daemon_serverthread.checked = True
+                daemon_serverthread.start()
+                daemon_queue.put('start')
+                return 0, daemon_serverthread
+
+        def join(self, daemon_serverthread):
+                while daemon_serverthread.is_alive():
+                        daemon_serverthread.join(timeout = 0.5)
+
+        def clean(self, daemon_serverthread):
+                server_terminate(daemon_serverthread, exit_server = True, exit_thread = True)
+
+def server_main_terminal():
+        # Parse options.
+        server_options()
+        # Check options.
+        server_check()
+        serverthread.checked = True
+
+        # Run threaded server.
+        serverqueue.put('start')
+        # Wait to finish.
+        try:
+                while serverthread.is_alive():
+                        serverthread.join(timeout = 0.5)
+        except (KeyboardInterrupt, SystemExit):
+                server_terminate(serverthread, exit_server = True, exit_thread = True)
+
+class kmsServerHandler(socketserver.BaseRequestHandler):
+        def setup(self):
+                loggersrv.info("Connection accepted: %s:%d" %(self.client_address[0], self.client_address[1]))
+                srv_config['raddr'] = str(self.client_address[0])
+
+        def handle(self):
+                self.request.settimeout(srv_config['timeoutsndrcv'])
+                while True:
+                        # self.request is the TCP socket connected to the client
+                        try:
+                                self.data = self.request.recv(1024)
+                                if self.data == '' or not self.data:
+                                        pretty_printer(log_obj = loggersrv.debug, # use debug, as the healthcheck will spam this
+                                                       put_text = "{reverse}{yellow}{bold}No data received.{end}")
+                                        break
+                        except socket.error as e:
+                                pretty_printer(log_obj = loggersrv.error,
+                                               put_text = "{reverse}{red}{bold}While receiving: %s{end}" %str(e))
+                                break
+                        
+                        packetType = MSRPCHeader(self.data)['type']
+                        if packetType == rpcBase.packetType['bindReq']:
+                                loggersrv.info("RPC bind request received.")
+                                pretty_printer(num_text = [-2, 2], where = "srv")
+                                handler = pykms_RpcBind.handler(self.data, srv_config)
+                        elif packetType == rpcBase.packetType['request']:
+                                loggersrv.info("Received activation request.")
+                                pretty_printer(num_text = [-2, 13], where = "srv")
+                                handler = pykms_RpcRequest.handler(self.data, srv_config)
+                        else:
+                                pretty_printer(log_obj = loggersrv.error,
+                                               put_text = "{reverse}{red}{bold}Invalid RPC request type %s.{end}" %packetType)
+                                break
+
+                        res = enco(str(handler.populate()), 'latin-1')
+
+                        if packetType == rpcBase.packetType['bindReq']:
+                                loggersrv.info("RPC bind acknowledged.")
+                                pretty_printer(num_text = [-3, 5, 6], where = "srv")
+                        elif packetType == rpcBase.packetType['request']:
+                                loggersrv.info("Responded to activation request.")
+                                pretty_printer(num_text = [-3, 18, 19], where = "srv")
+
+                        try:
+                                self.request.send(res)
+                                if packetType == rpcBase.packetType['request']:
+                                        break
+                        except socket.error as e:
+                                pretty_printer(log_obj = loggersrv.error,
+                                               put_text = "{reverse}{red}{bold}While sending: %s{end}" %str(e))
+                                break
+
+        def finish(self):
+                self.request.close()
+                loggersrv.info("Connection closed: %s:%d" %(self.client_address[0], self.client_address[1]))
+
+
+serverqueue = Queue.Queue(maxsize = 0)
+serverthread = server_thread(serverqueue, name = "Thread-Srv")
+serverthread.daemon = True
+serverthread.start()
+
+if __name__ == "__main__":
+        server_main_terminal()

rootfs/opt/py-kms/pykms_Sql.py

@@ -0,0 +1,142 @@
+#!/usr/bin/env python3
+
+import datetime
+import os
+import logging
+
+# sqlite3 is optional.
+try:
+        import sqlite3
+except ImportError:
+        pass
+
+from pykms_Format import pretty_printer
+
+#--------------------------------------------------------------------------------------------------------------------------------------------------------
+
+loggersrv = logging.getLogger('logsrv')
+
+def sql_initialize(dbName):
+        if not os.path.isfile(dbName):
+                # Initialize the database.
+                loggersrv.debug(f'Initializing database file "{dbName}"...')
+                con = None
+                try:
+                        con = sqlite3.connect(dbName)
+                        cur = con.cursor()
+                        cur.execute("CREATE TABLE clients(clientMachineId TEXT , machineName TEXT, applicationId TEXT, skuId TEXT, licenseStatus TEXT, lastRequestTime INTEGER, kmsEpid TEXT, requestCount INTEGER, machineIp TEXT, PRIMARY KEY(clientMachineId, applicationId))")
+
+                except sqlite3.Error as e:
+                        pretty_printer(log_obj = loggersrv.error, to_exit = True, put_text = "{reverse}{red}{bold}Sqlite Error: %s. Exiting...{end}" %str(e))
+                finally:
+                        if con:
+                                con.commit()
+                                con.close()                                
+        else:
+                # Update the database.
+                loggersrv.debug(f'Updating database file "{dbName}"...')
+                con = None
+                try:
+                        con = sqlite3.connect(dbName)
+                        cur = con.cursor()
+                        cur.execute("ALTER TABLE clients ADD COLUMN machineIp TEXT")
+
+                except sqlite3.Error as e:
+                        pretty_printer(log_obj = loggersrv.debug, to_exit = False, put_text = "{reverse}Sqlite Error: %s.{end}" %str(e))
+                finally:
+                        if con:
+                                con.commit()
+                                con.close()
+                                
+
+
+def sql_get_all(dbName):
+        if not os.path.isfile(dbName):
+                return None
+        with sqlite3.connect(dbName) as con:
+                cur = con.cursor()
+                cur.execute("SELECT * FROM clients ORDER BY lastRequestTime DESC")
+                clients = []
+                for row in cur.fetchall():
+                        clients.append({
+                                'clientMachineId': row[0],
+                                'machineName': row[1],
+                                'applicationId': row[2],
+                                'skuId': row[3],
+                                'licenseStatus': row[4],
+                                'lastRequestTime': datetime.datetime.fromtimestamp(row[5]).isoformat(),
+                                'kmsEpid': row[6],
+                                'requestCount': row[7],
+                                'machineIp': row[8],
+                        })
+                return clients
+
+def sql_update(dbName, infoDict):
+        con = None
+        try:
+                con = sqlite3.connect(dbName)
+                cur = con.cursor()
+                cur.execute("SELECT * FROM clients WHERE clientMachineId=:clientMachineId AND applicationId=:appId;", infoDict)
+                try:
+                        data = cur.fetchone()
+                        if not data:
+                                # Insert row.
+                                cur.execute("INSERT INTO clients (clientMachineId, machineName, applicationId, \
+skuId, licenseStatus, lastRequestTime, requestCount, machineIp) VALUES (:clientMachineId, :machineName, :appId, :skuId, :licenseStatus, :requestTime, 1, :machineIp);", infoDict)
+                        else:
+                                # Update data.
+                                if data[1] != infoDict["machineName"]:
+                                        cur.execute("UPDATE clients SET machineName=:machineName WHERE \
+clientMachineId=:clientMachineId AND applicationId=:appId;", infoDict)
+                                if data[2] != infoDict["appId"]:
+                                        cur.execute("UPDATE clients SET applicationId=:appId WHERE \
+clientMachineId=:clientMachineId AND applicationId=:appId;", infoDict)
+                                if data[3] != infoDict["skuId"]:
+                                        cur.execute("UPDATE clients SET skuId=:skuId WHERE \
+clientMachineId=:clientMachineId AND applicationId=:appId;", infoDict)
+                                if data[4] != infoDict["licenseStatus"]:
+                                        cur.execute("UPDATE clients SET licenseStatus=:licenseStatus WHERE \
+clientMachineId=:clientMachineId AND applicationId=:appId;", infoDict)
+                                if data[5] != infoDict["requestTime"]:
+                                        cur.execute("UPDATE clients SET lastRequestTime=:requestTime WHERE \
+clientMachineId=:clientMachineId AND applicationId=:appId;", infoDict)
+                                if data[8] != infoDict["machineIp"]:
+                                        cur.execute("UPDATE clients SET machineIp=:machineIp WHERE \
+clientMachineId=:clientMachineId AND applicationId=:appId;", infoDict)
+                                # Increment requestCount
+                                cur.execute("UPDATE clients SET requestCount=requestCount+1 WHERE \
+clientMachineId=:clientMachineId AND applicationId=:appId;", infoDict)
+
+                except sqlite3.Error as e:
+                        pretty_printer(log_obj = loggersrv.error, to_exit = True,
+                                       put_text = "{reverse}{red}{bold}Sqlite Error: %s. Exiting...{end}" %str(e))
+        except sqlite3.Error as e:
+                pretty_printer(log_obj = loggersrv.error, to_exit = True,
+                               put_text = "{reverse}{red}{bold}Sqlite Error: %s. Exiting...{end}" %str(e))
+        finally:
+                if con:
+                    con.commit()
+                    con.close()
+
+def sql_update_epid(dbName, kmsRequest, response, appName):
+        cmid = str(kmsRequest['clientMachineId'].get())
+        con = None
+        try:
+                con = sqlite3.connect(dbName)
+                cur = con.cursor()
+                cur.execute("SELECT * FROM clients WHERE clientMachineId=? AND applicationId=?;", (cmid, appName))
+                try:
+                        data = cur.fetchone()
+                        cur.execute("UPDATE clients SET kmsEpid=? WHERE \
+clientMachineId=? AND applicationId=?;", (str(response["kmsEpid"].decode('utf-16le')), cmid, appName))
+
+                except sqlite3.Error as e:
+                        pretty_printer(log_obj = loggersrv.error, to_exit = True,
+                                       put_text = "{reverse}{red}{bold}Sqlite Error: %s. Exiting...{end}" %str(e))
+        except sqlite3.Error as e:
+                pretty_printer(log_obj = loggersrv.error, to_exit = True,
+                               put_text = "{reverse}{red}{bold}Sqlite Error: %s. Exiting...{end}" %str(e))
+        finally:
+                if con:
+                        con.commit()
+                        con.close()