ae454da94480a4511c8cf73d8fbe95c1a48a8f58 to experimental · firmware / FFS Gluon

Some changes are not shown.

For a faster browsing experience, only 75 of 868 files are shown. Download one of the files below to see all changes.

.ecrc0 → 100644

+3
−0

Original line number
Diff line number
Diff line

{

  "Exclude": ["docs/_build"]

}

.editorconfig0 → 100644

+67
−0

Original line number
Diff line number
Diff line

# Top-most EditorConfig file

root = true

[*]

end_of_line = lf

insert_final_newline = true

indent_style = tab

charset = utf-8

[Dockerfile]

indent_style = space

indent_size = 4

[/patches/**]

indent_style = unset

indent_size = unset

[*.c]

[*.css]

[*.dia]

indent_style = space

indent_size = 2

[*.h]

[*.html]

[*.js]

[*{.json,.ecrc}]

indent_style = space

indent_size = 2

[*.lua]

[{Makefile,*.mk}]

indent_style = unset

[*.md]

indent_style = space

indent_size = 4

[*.pl]

[*.py]

indent_style = space

indent_size = 4

[*.rst]

indent_style = space

indent_size = 2

[*.sh]

[*.yml]

indent_style = space

indent_size = 2

[CMakeLists.txt]

indent_style = space

indent_size = 2

[{docs,contrib/ci}/*site*/**/*.conf]

indent_style = space

indent_size = 2

.github/ISSUE_TEMPLATE/bug_report.md0 → 100644

+71
−0

Original line number
Diff line number
Diff line

---

name: Bug report

about: Report a bug in a recent version of Gluon

label: bug

---

<!--

Please carefully fill out the questionnaire below to help improve the

timely triaging of issues. Walk through the questions below and use

them as an inspiration for what information you can provide.

Make use of codeblocks (three backticks before and after) where

appropriate (configuration excerpts, log output, etc.). Example:

```

your code goes here

```

You can use the "Preview" tab to check how your issue is going to look

before you actually send it in.

Thank you for taking the time to report a bug with the Gluon project.

-->

### Bug report

**What is the problem?**

<!--

- What is not working as expected?

- How is it misbehaving?

- When did the problem first start showing up?

- What were you doing when you first noticed the problem?

- On which devices (vendor, model and revision) is it misbehaving?

- Does the issue appear on multiple devices or targets?

-->

**What is the expected behaviour?**

<!--

- How do you think it should work instead?

- Did it work like that before?

-->

**Gluon Version:**

<!--

Please provide a usable Git reference before applying custom patches:

By using a Git reference:

    $ git describe --always

    v2018.2-17-g3abadc28

Or the URL to the relevant Gluon commit

    https://github.com/freifunk-gluon/gluon/commit/<commit hash here>

-->

**Site Configuration:**

<!--

Please provide the URL to your site configuration repository and the

explicit commit used to build the firmware experiencing the problem.

Additionally excerpts of problem-related configuration parts are 

often helpful.

-->

**Custom patches:**

<!--

Be upfront about any custom patches you have applied to your Gluon build, as they might

be part of your problem.

-->

.github/dependabot.yml0 → 100644

+12
−0

Original line number
Diff line number
Diff line

# Docs: <https://docs.github.com/en/code-security/dependabot/dependabot-version-updates/customizing-dependency-updates>

version: 2

updates:

  - package-ecosystem: github-actions

    directory: /

    schedule: {interval: monthly}

  - package-ecosystem: pip

    directory: /docs/

    schedule: {interval: monthly}

.github/filters.yml0 → 100644

+345
−0

Original line number
Diff line number
Diff line

{

  "armsr-armv7": [

    "targets/armsr-armv7",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk",

    "targets/armsr.inc"

  ],

  "armsr-armv8": [

    "targets/armsr-armv8",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk",

    "targets/armsr.inc"

  ],

  "ath79-generic": [

    "targets/ath79-generic",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk"

  ],

  "ath79-nand": [

    "targets/ath79-nand",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk"

  ],

  "ath79-mikrotik": [

    "targets/ath79-mikrotik",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk",

    "targets/mikrotik.inc"

  ],

  "bcm27xx-bcm2708": [

    "targets/bcm27xx-bcm2708",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk",

    "targets/bcm27xx.inc"

  ],

  "bcm27xx-bcm2709": [

    "targets/bcm27xx-bcm2709",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk",

    "targets/bcm27xx.inc"

  ],

  "ipq40xx-generic": [

    "targets/ipq40xx-generic",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk"

  ],

  "ipq40xx-mikrotik": [

    "targets/ipq40xx-mikrotik",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk",

    "targets/mikrotik.inc"

  ],

  "ipq806x-generic": [

    "targets/ipq806x-generic",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk"

  ],

  "lantiq-xrx200": [

    "targets/lantiq-xrx200",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk"

  ],

  "lantiq-xrx200_legacy": [

    "targets/lantiq-xrx200_legacy",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk"

  ],

  "lantiq-xway": [

    "targets/lantiq-xway",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk"

  ],

  "mediatek-filogic": [

    "targets/mediatek-filogic",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk"

  ],

  "mediatek-mt7622": [

    "targets/mediatek-mt7622",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk"

  ],

  "mvebu-cortexa53": [

    "targets/mvebu-cortexa53",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk"

  ],

  "mpc85xx-p1010": [

    "targets/mpc85xx-p1010",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk"

  ],

  "mpc85xx-p1020": [

    "targets/mpc85xx-p1020",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk"

  ],

  "qualcommax-ipq807x": [

    "targets/qualcommax-ipq807x",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk"

  ],

  "ramips-mt7620": [

    "targets/ramips-mt7620",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk"

  ],

  "ramips-mt7621": [

    "targets/ramips-mt7621",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk"

  ],

  "ramips-mt76x8": [

    "targets/ramips-mt76x8",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk"

  ],

  "rockchip-armv8": [

    "targets/rockchip-armv8",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk"

  ],

  "sunxi-cortexa7": [

    "targets/sunxi-cortexa7",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk"

  ],

  "x86-generic": [

    "targets/x86-generic",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk",

    "targets/x86.inc"

  ],

  "x86-geode": [

    "targets/x86-geode",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk"

  ],

  "x86-legacy": [

    "targets/x86-legacy",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk",

    "targets/x86.inc"

  ],

  "x86-64": [

    "targets/x86-64",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk",

    "targets/x86.inc",

    "contrib/ci/minimal-site/**",

    "package/**"

  ],

  "bcm27xx-bcm2710": [

    "targets/bcm27xx-bcm2710",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk",

    "targets/bcm27xx.inc"

  ],

  "bcm27xx-bcm2711": [

    "targets/bcm27xx-bcm2711",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk",

    "targets/bcm27xx.inc"

  ],

  "ipq40xx-chromium": [

    "targets/ipq40xx-chromium",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk"

  ],

  "kirkwood-generic": [

    "targets/kirkwood-generic",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk"

  ],

  "mvebu-cortexa9": [

    "targets/mvebu-cortexa9",

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk"

  ]

}

.github/labeler.yml0 → 100644

+89
−0

Original line number
Diff line number
Diff line

---

"3. topic: batman-adv":

  - changed-files:

    - any-glob-to-any-file:

      - docs/package/gluon-mesh-batman-adv*

      - package/gluon-alfred/**

      - package/gluon-client-bridge/**

      - package/gluon-mesh-batman-adv/**

      - package/libbatadv/**

"3. topic: build":

  - changed-files:

    - any-glob-to-any-file:

      - Makefile

      - scripts/**

"3. topic: config-mode":

  - changed-files:

    - any-glob-to-any-file:

      - docs/dev/web/config-mode.rst

      - docs/package/gluon-config-mode-*

      - package/gluon-config-mode-*/**

      - package/gluon-web*/**

"3. topic: continuous integration":

  - changed-files:

    - any-glob-to-any-file:

      - .github/workflows/*

      - contrib/actions/**

      - contrib/ci/**

"3. topic: docs":

  - changed-files:

    - any-glob-to-any-file:

      - docs/**

"3. topic: fastd":

  - changed-files:

    - any-glob-to-any-file:

      - docs/features/fastd*

      - package/gluon-mesh-vpn-fastd/**

"3. topic: firewall":

  - changed-files:

    - any-glob-to-any-file:

      - package/**/*-firewall

      - package/gluon-ebtables-*/**

"3. topic: hardware":

  - changed-files:

    - any-glob-to-any-file:

      - package/gluon-core/luasrc/lib/gluon/upgrade/010-primary-mac

      - package/gluon-core/luasrc/usr/lib/lua/gluon/platform.lua

      - targets/*

"3. topic: multidomain":

  - changed-files:

    - any-glob-to-any-file:

      - docs/features/multidomain*

      - docs/multidomain-site-example/**

      - package/gluon-config-mode-domain-select/**

      - package/gluon-scheduled-domain-switch/**

"3. topic: olsr":

  - changed-files:

    - any-glob-to-any-file:

      - package/gluon-l3roamd/**

      - package/gluon-mesh-olsrd/**

      - package/gluon-mmfd/**

"3. topic: package":

  - changed-files:

    - any-glob-to-any-file:

      - package/**

"3. topic: respondd":

  - changed-files:

    - any-glob-to-any-file:

      - package/**/*respondd*

      - package/gluon-respondd/**

"3. topic: status-page":

  - changed-files:

    - any-glob-to-any-file:

      - package/gluon-status-page/**

"3. topic: tests":

  - changed-files:

    - any-glob-to-any-file:

      - tests/**

"3. topic: wireguard":

  - changed-files:

    - any-glob-to-any-file:

      - package/gluon-mesh-vpn-wireguard/**

"3. topic: wireless":

  - changed-files:

    - any-glob-to-any-file:

      - package/gluon-mesh-wireless-sae/**

      - package/gluon-private-wifi/**

      - package/gluon-web-private-wifi/**

      - package/gluon-web-wifi-config/**

      - package/gluon-wireless-encryption-wpa3/**

.github/workflows/backport.yml0 → 100644

+20
−0

Original line number
Diff line number
Diff line

name: Backport

on:

  pull_request_target:

    types: [closed, labeled]

permissions:

  contents: write # so it can comment

  pull-requests: write # so it can create pull requests

jobs:

  backport:

    name: Backport Pull Request

    if: github.repository_owner == 'freifunk-gluon' && github.event.pull_request.merged == true && (github.event_name != 'labeled' || startsWith('backport', github.event.label.name))

    runs-on: ubuntu-22.04

    steps:

      - uses: actions/checkout@v5

      - name: Create backport PRs

        uses: korthout/backport-action@v3.3.0

        with:

          # Config README: https://github.com/korthout/backport-action#backport-action

          pull_description: |-

            Automatic backport to `${target_branch}`, triggered by a label in #${pull_number}.

.github/workflows/build-container.yml0 → 100644

+48
−0

Original line number
Diff line number
Diff line

# Based on the example from https://docs.github.com/en/actions/publishing-packages/publishing-docker-images

name: Create and publish a Docker image

on:

  push:

    branches:

      - 'main'

      - 'next'

      - 'v202[0-9].[0-9].x'

    tags:

      - 'v*'

  pull_request:

env:

  REGISTRY: ghcr.io

  IMAGE_NAME: ${{ github.repository }}-build

jobs:

  build-and-push-image:

    runs-on: ubuntu-22.04

    permissions: write-all

    steps:

      - name: Checkout repository

        uses: actions/checkout@v5

      - name: Set up QEMU

        uses: docker/setup-qemu-action@v3

      - name: Set up Docker Buildx

        uses: docker/setup-buildx-action@v3

      - name: Log in to the Container registry

        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef

        if: ${{ github.repository_owner == 'freifunk-gluon' && github.event_name == 'push' }}

        with:

          registry: ${{ env.REGISTRY }}

          username: ${{ github.actor }}

          password: ${{ secrets.GITHUB_TOKEN }}

      - name: Extract metadata (tags, labels) for Docker

        id: meta

        uses: docker/metadata-action@c1e51972afc2121e065aed6d45c65596fe445f3f

        with:

          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}

      - name: Build and push Docker image

        uses: docker/build-push-action@263435318d21b8e681c14492fe198d362a7d2c83

        with:

          context: ./contrib/docker

          push: ${{ github.repository_owner == 'freifunk-gluon' && github.event_name == 'push' }}

          platforms: linux/amd64,linux/arm64

          tags: ${{ steps.meta.outputs.tags }}

          labels: ${{ steps.meta.outputs.labels }}

.github/workflows/build-docs.yml0 → 100644

+29
−0

Original line number
Diff line number
Diff line

name: Build Documentation

on:

  push:

    paths:

      - 'docs/**'

      - '.github/workflows/build-docs.yml'

  pull_request:

    types: [opened, synchronize, reopened]

    paths:

      - 'docs**/'

      - '.github/workflows/build-docs.yml'

permissions:

  contents: read

jobs:

  build-documentation:

    name: docs

    runs-on: ubuntu-24.04

    steps:

      - uses: actions/checkout@v5

      - name: Install Dependencies

        run: sudo pip3 install -r docs/requirements.txt

      - name: Build documentation

        run: make -C docs html

      - name: Archive build output

        uses: actions/upload-artifact@v4

        with:

          name: docs_output

          path: docs/_build/html

.github/workflows/build-gluon.yml0 → 100644

+80
−0

Original line number
Diff line number
Diff line

name: Build Gluon

on:

  push:

    branches:

      - main

      - next

      - 'v20[2-9][0-9].[0-9].x'

  pull_request:

    types: [opened, synchronize, reopened]

  workflow_dispatch:

permissions:

  contents: read

concurrency:

  group: ${{ github.workflow }}-${{ github.ref || github.run_id }}-${{ github.event.pull_request.number || github.run_id }}

  cancel-in-progress: true

jobs:

  changed:

    permissions:

      contents: read  # for dorny/paths-filter to fetch a list of changed files

      pull-requests: read  # for dorny/paths-filter to read pull requests

    runs-on: ubuntu-22.04

    outputs:

      targets: ${{ steps.filter.outputs.changes }}

    steps:

      - uses: actions/checkout@v5

      # Filter targets based on changed files

      - uses: dorny/paths-filter@v3

        id: filter

        with:

          filters: .github/filters.yml

  build_firmware:

    needs: changed

    if: ${{ needs.changed.outputs.targets != '[]' && needs.changed.outputs.targets != '' }}

    strategy:

      fail-fast: false

      matrix:

        # Read back changed targets to create build matrix

        target: ${{ fromJSON(needs.changed.outputs.targets) }}

    runs-on: ubuntu-22.04

    steps:

      - uses: actions/checkout@v5

      - name: Show system information

        run: contrib/actions/show-system-info.sh

      - name: Remove non-required software

        run: contrib/actions/free-runner-space.sh

      - name: Build Docker container

        run: docker build -t gluon-ci-container contrib/docker

      - name: Build Gluon

        run: docker run --rm -v $PWD:/gluon-ci -w /gluon-ci --user "$(id -u):$(id -g)" gluon-ci-container contrib/actions/run-build.sh ${{ matrix.target }}

      - name: Check Image size

        run: contrib/check-image-size.py --github-actions --overhead 256 output/meta/openwrt-profiles/${{ matrix.target }}.json

      - name: Archive build logs

        if: ${{ !cancelled() }}

        uses: actions/upload-artifact@v4

        with:

          name: ${{ matrix.target }}_logs

          path: openwrt/logs

      - name: Archive build output

        uses: actions/upload-artifact@v4

        with:

          name: ${{ matrix.target }}_output

          path: output

      - name: Archive metadata

        uses: actions/upload-artifact@v4

        with:

          name: ${{ matrix.target }}_metadata

          path: output/meta

.github/workflows/bump-gluon.yml0 → 100644

+51
−0

Original line number
Diff line number
Diff line

---

name: "Update OpenWrt base"

on:

  workflow_dispatch:

    inputs:

      branch:

        description: "Branch to create update for"

        required: true

        default: "main"

jobs:

  update-openwrt:

    runs-on: ubuntu-22.04

    env:

      COMMIT_NAME: Gluon CI Bot

      COMMIT_EMAIL: bot@freifunk-gluon.github.io

    steps:

      - name: Clone Gluon

        uses: actions/checkout@v5

        with:

          ref: ${{ github.event.inputs.branch }}

      - name: Configure Git User and E-Mail

        run: git config --global user.name "${{ env.COMMIT_NAME }}" && git config --global user.email "${{ env.COMMIT_EMAIL }}"

      - name: Get update branch name

        id: branch-name

        run: echo "branch-name=update-openwrt-${{ github.event.inputs.branch }}-$(date +%s)" >> $GITHUB_OUTPUT

      - name: Link example Site

        run: ln -s docs/site-example site

      - name: Invoke update-modules

        run: make update-modules

      - name: Refresh patches

        run: make refresh-patches

      - name: Check if unstaged commits exist

        run: git diff --exit-code || echo "::warning::Patches need a manual refresh"

      - name: Checkout individual branch name

        run: git checkout -b ${{ steps.branch-name.outputs.branch-name }}

      - name: Push branch

        run: git push origin HEAD

      - name: Emit PR creation message

        run:

          echo "::notice::Create pull-request at https://github.com/${{ github.repository }}/compare/${{ github.event.inputs.branch }}...${{ steps.branch-name.outputs.branch-name }}?quick_pull=1"

.github/workflows/check-ci.yml0 → 100644

+22
−0

Original line number
Diff line number
Diff line

name: Check generated CI

on:

  push:

  pull_request:

    types: [opened, synchronize, reopened]

permissions:

  contents: read

jobs:

  check-ci:

    name: Check generated CI

    runs-on: ubuntu-22.04

    steps:

      - uses: actions/checkout@v5

      - name: Install example site

        run: ln -s ./docs/site-example ./site

      - name: Update CI

        run: make update-ci

      - name: Show diff

        run: git status; git diff

      - name: Patch status

        run: git diff-files --quiet

.github/workflows/check-patches.yml0 → 100644

+30
−0

Original line number
Diff line number
Diff line

---

name: Check patches

on:

  push:

    paths:

      - 'modules'

      - 'patches/**'

      - '.github/workflows/check-patches.yml'

  pull_request:

    types: [opened, synchronize, reopened]

    paths:

      - 'modules'

      - 'patches/**'

      - '.github/workflows/check-patches.yml'

permissions:

  contents: read

jobs:

  check-patches:

    name: Check patches

    runs-on: ubuntu-22.04

    steps:

      - uses: actions/checkout@v5

      - name: Refresh patches

        run: make refresh-patches GLUON_SITEDIR="contrib/ci/minimal-site"

      - name: Show diff

        run: git status; git diff

      - name: Patch status

        run: git diff-files --quiet

.github/workflows/labels.yml0 → 100644

+21
−0

Original line number
Diff line number
Diff line

name: "Label PRs"

on:

  # only execute base branch actions

  pull_request_target:

permissions:

  contents: read

jobs:

  labels:

    permissions:

      contents: read  # for actions/labeler to determine modified files

      pull-requests: write  # for actions/labeler to add labels to PRs

    runs-on: ubuntu-22.04

    if: github.repository_owner == 'freifunk-gluon'

    steps:

    - uses: actions/labeler@v6

      with:

        repo-token: ${{ secrets.GITHUB_TOKEN }}

        sync-labels: true

.github/workflows/lint.yml0 → 100644

+54
−0

Original line number
Diff line number
Diff line

name: Lint

on:

  push:

  pull_request:

    types: [opened, synchronize, reopened]

permissions:

  contents: read

jobs:

  lua:

    name: Lua

    runs-on: ubuntu-22.04

    steps:

      - uses: actions/checkout@v5

      - name: Install Dependencies

        run: sudo apt-get -y update && sudo apt-get -y install lua-check

      - name: Install example site

        run: ln -s ./docs/site-example ./site

      - name: Lint Lua code

        run: make lint-lua

  sh:

    name: Shell

    runs-on: ubuntu-22.04

    steps:

      - uses: actions/checkout@v5

      - name: Install Dependencies

        run: sudo apt-get -y update && sudo apt-get -y install shellcheck

      - name: Install example site

        run: ln -s ./docs/site-example ./site

      - name: Lint shell code

        run: make lint-sh

  editorconfig:

    name: Editorconfig

    runs-on: ubuntu-22.04

    steps:

      - uses: actions/checkout@v5

      - name: Install Dependencies

        run: sudo apt install curl tar

      - name: Install editorconfig-checker

        env:

          VERSION: 2.7.0

          OS: linux

          ARCH: amd64

        run: |

          curl -O -L -C - https://github.com/editorconfig-checker/editorconfig-checker/releases/download/$VERSION/ec-$OS-$ARCH.tar.gz

          tar xzf ec-$OS-$ARCH.tar.gz

          sudo mv ./bin/ec-$OS-$ARCH /usr/bin/editorconfig-checker

          sudo chmod +x /usr/bin/editorconfig-checker

      - name: Install example site

        run: ln -s ./docs/site-example ./site

      - name: Lint editorconfig

        run: make lint-editorconfig

.gitignore

+7
−4

Original line number
Diff line number
Diff line

*~

/build

/images

/site

/openwrt

/output

/site

/tmp

/packages

/modules.local

.bash_history

.subversion

.wget-hsts

/.scmversion

.luacheckrc0 → 100644

+119
−0

Original line number
Diff line number
Diff line

codes = true

std = "min"

self = false

read_globals = {

	"getfenv",

	"setfenv",

	"unpack",

}

include_files = {

	"**/*.lua",

	"package/**/luasrc/**/*",

	"targets/*",

	"package/features",

}

exclude_files = {

	"**/*.mk",

}

files["package/**/check_site.lua"] = {

	read_globals = {

		"alternatives",

		"extend",

		"in_domain",

		"in_site",

		"value",

		"need",

		"need_alphanumeric_key",

		"need_array",

		"need_array_elements_exclusive",

		"need_array_of",

		"need_boolean",

		"need_chanlist",

		"need_domain_name",

		"need_number",

		"need_number_range",

		"need_one_of",

		"need_string",

		"need_string_array",

		"need_string_array_match",

		"need_string_match",

		"need_table",

		"need_value",

		"obsolete",

		"table_keys",

		"this_domain",

	},

}

files["package/**/luasrc/lib/gluon/config-mode/*"] = {

	globals = {

		"MultiListValue",

		"DynamicList",

		"Flag",

		"Form",

		"i18n",

		"ListValue",

		"renderer.render",

		"renderer.render_string",

		"Section",

		"TextValue",

		"_translate",

		"translate",

		"translatef",

		"Value",

		"Element",

	},

}

files["package/**/luasrc/lib/gluon/**/controller/*"] = {

	read_globals = {

		"_",

		"alias",

		"call",

		"entry",

		"model",

		"node",

		"template",

	},

}

files["package/**/luasrc/lib/gluon/ebtables/*"] = {

	read_globals = {

		"chain",

		"rule",

	},

	max_line_length = false,

}

files["targets/*"] = {

	read_globals = {

		"class",

		"config",

		"defaults",

		"device",

		"env",

		"exec",

		"exec_capture",

		"exec_capture_raw",

		"exec_raw",

		"factory_image",

		"include",

		"istrue",

		"no_opkg",

		"packages",

		"sysupgrade_image",

		"try_config",

	},

}

files["package/features"] = {

	read_globals = {

		"_",

		"feature",

		"when",

	},

}

.readthedocs.yaml0 → 100644

+20
−0

Original line number
Diff line number
Diff line

# .readthedocs.yaml

# Read the Docs configuration file

# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details

# Required

version: 2

# Build documentation in the docs/ directory with Sphinx

sphinx:

  configuration: docs/conf.py

# Optionally set the version of Python and requirements required to build your docs

python:

   install:

   - requirements: docs/requirements.txt

build:

    os: ubuntu-22.04

    tools:

        python: "3.11"

CONTRIBUTING.md0 → 100644

+53
−0

Original line number
Diff line number
Diff line

Contribution Guidelines

=======================

Because Gluon is such a universal software package that is used by several

different communities with different expectations and requirements, it is both

essential and difficult to have contributions from the communities. While they

are sometimes necessary to adapt Gluon to the needs of the communities, they

also have to be adaptable enough to fit as many needs as possible. On the other

hands, very special needs are better addressed in [packages] in community

repositories, because the Gluon maintainers would not use or test them and

thus couldn't do their "job" of maintaining them.

To ease the work for the maintainers and to reduce the frustration of

contributors, please adhere to the following guidelines:

Discuss first, build later

--------------------------

If you have some non-trivial enhancement like a new package, some modification

of what is announced by a node, it is often best to first discuss the precise

solution first. The maintainers might have hints as to how a solution could be

implemented easiest, point out solutions how the same thing can already be done

using other parts or why the proposed change breaks other parts of the system.

They might even refuse the idea altogether - after all, they have to sleep well

after merging the changes, too.

The preferred way to discuss is in the IRC channel ([#gluon] on irc.hackint.org)

or on the [mailing list], however, you can also open a new issue on GitHub to

discuss there. We maintain a [list of rejected features] and we'd like to

kindly ask you to review it first. In general, looking for duplicates may save

you some time.

Develop on top of main

----------------------

If you are not developing something specific to a release (like for example a

security fix to a feature that got completely rewritten since the release),

develop it on top of the main branch. New features and even feature changes

aren't usually backported to old releases, but will be included in the upcoming

release, which will be built from main.

Use descriptive commit messages

-------------------------------

If you modify a single package, start the first line of your commit message

with the package name followed by a colon. The first line should be enough to

identify the commit a week later and still know roughly what it did. If you

fix some bug, detail in the remaining commit message exactly how it could be

triggered and what you did to fix it. If in question, have a glance at the

existing commit messages to get the idea.

[packages]: https://gluon.readthedocs.io/en/latest/user/site.html#packages

[#gluon]: https://chat.hackint.org/?join=gluon

[mailing list]: mailto:gluon@luebeck.freifunk.net

[list of rejected features]: https://github.com/freifunk-gluon/gluon/issues?q=label%3A%222.+status%3A+rejected%22

LICENSE

+8
−5

Original line number
Diff line number
Diff line

BSD 2-Clause License

The code of Project Gluon may be distributed under the following terms, unless

noted otherwise in indiviual files or subtrees.

noted otherwise in individual files or subtrees.

Copyright (c) 2013, Project Gluon

Copyright (c) Project Gluon

All rights reserved.

Redistribution and use in source and binary forms, with or without

@@ -25,9 +27,10 @@ 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.

OpenWRT is licensed under the terms of the GNU General Public License Version 2,

which can be found under openwrt/LICENSE after the openwrt submodule has been

obtained. This applies to the following submodules:

OpenWrt is licensed under the terms of the GNU General Public License Version 2,

which can be found at openwrt/LICENSE after the OpenWrt repository has been

obtained. This applies to the following repositories:

 * openwrt

 * packages/openwrt

 * packages/routing

Makefile

+194
−326

Original line number
Diff line number
Diff line

@@ -4,377 +4,245 @@ LC_ALL:=C

LANG:=C

export LC_ALL LANG

empty:=

space:= $(empty) $(empty)

.SHELLFLAGS = -ec

GLUONMAKE_EARLY = $(SUBMAKE) -C $(GLUON_ORIGOPENWRTDIR) -f $(GLUONDIR)/Makefile GLUON_TOOLS=0

GLUONMAKE = $(SUBMAKE) -C $(GLUON_OPENWRTDIR) -f $(GLUONDIR)/Makefile

ifneq ($(OPENWRT_BUILD),1)

GLUONDIR:=${CURDIR}

include $(GLUONDIR)/include/gluon.mk

TOPDIR:=$(GLUON_ORIGOPENWRTDIR)

export TOPDIR

GLUON_TARGET ?= ar71xx-generic

export GLUON_TARGET

update: FORCE

	$(GLUONDIR)/scripts/update.sh $(GLUONDIR)

	$(GLUONDIR)/scripts/patch.sh $(GLUONDIR)

patch: FORCE

	$(GLUONDIR)/scripts/patch.sh $(GLUONDIR)

unpatch: FORCE

	$(GLUONDIR)/scripts/unpatch.sh $(GLUONDIR)

update-patches: FORCE

	$(GLUONDIR)/scripts/update.sh $(GLUONDIR)

	$(GLUONDIR)/scripts/update-patches.sh $(GLUONDIR)

	$(GLUONDIR)/scripts/patch.sh $(GLUONDIR)

-include $(TOPDIR)/include/host.mk

_SINGLE=export MAKEFLAGS=$(space);

override OPENWRT_BUILD=1

override GLUON_TOOLS=1

GREP_OPTIONS=

export OPENWRT_BUILD GLUON_TOOLS GREP_OPTIONS

-include $(TOPDIR)/include/debug.mk

-include $(TOPDIR)/include/depends.mk

include $(GLUONDIR)/include/toplevel.mk

define GluonProfile

image/$(1): FORCE

	+@$$(GLUONMAKE) $$@

endef

define GluonModel

# check for spaces & resolve possibly relative paths

define mkabspath

   ifneq (1,$(words [$($(1))]))

     $$(error $(1) must not contain spaces)

   endif

   override $(1) := $(abspath $($(1)))

endef

include $(GLUONDIR)/targets/targets.mk

include $(GLUONDIR)/targets/$(GLUON_TARGET)/profiles.mk

CheckExternal := test -d $(GLUON_ORIGOPENWRTDIR) || (echo 'You don'"'"'t seem to have obtained the external repositories needed by Gluon; please call `make update` first!'; false)

escape = '$(subst ','\'',$(1))'

GLUON_SITEDIR ?= site

$(eval $(call mkabspath,GLUON_SITEDIR))

prepare-target: FORCE

	@$(CheckExternal)

	+@$(GLUONMAKE_EARLY) prepare-target

all: prepare-target

	+@$(GLUONMAKE) prepare

	+@$(GLUONMAKE) images

ifeq ($(realpath $(GLUON_SITEDIR)/site.mk),)

$(error No site configuration was found. Please check out a site configuration to $(GLUON_SITEDIR))

endif

prepare: prepare-target

	+@$(GLUONMAKE) $@

include $(GLUON_SITEDIR)/site.mk

clean dirclean download images: FORCE

	@$(CheckExternal)

	+@$(GLUONMAKE_EARLY) maybe-prepare-target

	+@$(GLUONMAKE) $@

GLUON_RELEASE ?= $(error GLUON_RELEASE not set. GLUON_RELEASE can be set in site.mk or on the command line)

toolchain/% package/% target/%: FORCE

	@$(CheckExternal)

	+@$(GLUONMAKE_EARLY) maybe-prepare-target

	+@$(GLUONMAKE) $@

GLUON_DEPRECATED ?= 0

manifest: FORCE

	[ -n '$(GLUON_BRANCH)' ] || (echo 'Please set GLUON_BRANCH to create a manifest.'; false)

	echo '$(GLUON_PRIORITY)' | grep -qE '^([0-9]*\.)?[0-9]+$$' || (echo 'Please specify a numeric value for GLUON_PRIORITY to create a manifest.'; false)

	@$(CheckExternal)

	+@$(GLUONMAKE_EARLY) maybe-prepare-target

	+@$(GLUONMAKE) $@

else

ifneq ($(GLUON_BRANCH),)

  $(warning *** Warning: GLUON_BRANCH has been deprecated, please set GLUON_AUTOUPDATER_BRANCH and GLUON_AUTOUPDATER_ENABLED instead.)

  GLUON_AUTOUPDATER_BRANCH ?= $(GLUON_BRANCH)

  GLUON_AUTOUPDATER_ENABLED ?= 1

endif

TOPDIR=${CURDIR}

export TOPDIR

ifneq ($(GLUON_FEATURES)$(GLUON_FEATURES_standard)$(GLUON_FEATURES_tiny),)

  $(error GLUON_FEATURES is obsolete, please use the image-customization.lua file instead)

endif

include rules.mk

ifneq ($(GLUON_SITE_PACKAGES)$(GLUON_SITE_PACKAGES_standard)$(GLUON_SITE_PACKAGES_tiny),)

  $(error GLUON_SITE_PACKAGES is obsolete, please use the image-customization.lua file instead)

endif

include $(GLUONDIR)/include/gluon.mk

GLUON_AUTOUPDATER_ENABLED ?= 0

# initialize (possibly already user set) directory variables

GLUON_TMPDIR ?= tmp

GLUON_OUTPUTDIR ?= output

GLUON_IMAGEDIR ?= $(GLUON_OUTPUTDIR)/images

GLUON_PACKAGEDIR ?= $(GLUON_OUTPUTDIR)/packages

GLUON_DEBUGDIR ?= $(GLUON_OUTPUTDIR)/debug

GLUON_METADIR ?= $(GLUON_OUTPUTDIR)/meta

GLUON_TARGETSDIR ?= targets

GLUON_PATCHESDIR ?= patches

$(eval $(call mkabspath,GLUON_TMPDIR))

$(eval $(call mkabspath,GLUON_OUTPUTDIR))

$(eval $(call mkabspath,GLUON_IMAGEDIR))

$(eval $(call mkabspath,GLUON_PACKAGEDIR))

$(eval $(call mkabspath,GLUON_TARGETSDIR))

$(eval $(call mkabspath,GLUON_PATCHESDIR))

GLUON_VERSION := $(shell scripts/getversion.sh '.')

# Set default SITE_VERSION if not set by user

GLUON_SITE_VERSION ?= $(shell scripts/getversion.sh '$(GLUON_SITEDIR)')

GLUON_MULTIDOMAIN ?= 0

GLUON_AUTOREMOVE ?= 0

GLUON_DEBUG ?= 1

GLUON_MINIFY ?= 1

# Can be overridden via environment/command line/... to use the Gluon

# build system for non-Gluon builds

define GLUON_BASE_FEEDS ?=

src-link gluon_base ../../package

endef

include $(INCLUDE_DIR)/host.mk

include $(INCLUDE_DIR)/depends.mk

include $(INCLUDE_DIR)/subdir.mk

GLUON_VARS = \

	GLUON_VERSION GLUON_SITE_VERSION \

	GLUON_RELEASE GLUON_REGION GLUON_MULTIDOMAIN GLUON_AUTOREMOVE GLUON_DEBUG GLUON_MINIFY GLUON_DEPRECATED \

	GLUON_DEVICES GLUON_TARGETSDIR GLUON_PATCHESDIR GLUON_TMPDIR GLUON_IMAGEDIR GLUON_PACKAGEDIR GLUON_DEBUGDIR \

	GLUON_METADIR GLUON_SITEDIR GLUON_AUTOUPDATER_BRANCH GLUON_AUTOUPDATER_ENABLED GLUON_LANGS GLUON_BASE_FEEDS \

	GLUON_TARGET BOARD SUBTARGET

include package/Makefile

include tools/Makefile

include toolchain/Makefile

include target/Makefile

unexport $(GLUON_VARS)

GLUON_ENV = $(foreach var,$(GLUON_VARS),$(var)=$(call escape,$($(var))))

show-release:

	@echo '$(GLUON_RELEASE)'

PROFILES :=

PROFILE_PACKAGES :=

define Profile

  $(eval $(call Profile/Default))

  $(eval $(call Profile/$(1)))

endef

update: FORCE

	@

	export $(GLUON_ENV)

	scripts/update.sh

	scripts/patch.sh

	scripts/feeds.sh

define GluonProfile

PROFILES += $(1)

PROFILE_PACKAGES += $(filter-out -%,$(2) $(GLUON_$(1)_SITE_PACKAGES))

GLUON_$(1)_DEFAULT_PACKAGES := $(2)

GLUON_$(1)_MODELS :=

update-patches: FORCE

	@

	export $(GLUON_ENV)

	scripts/update.sh

	scripts/update-patches.sh

	scripts/patch.sh

refresh-patches: FORCE

	@

	export $(GLUON_ENV)

	scripts/update.sh

	scripts/patch.sh

	scripts/update-patches.sh

update-feeds: FORCE

	@$(GLUON_ENV) scripts/feeds.sh

update-modules: FORCE

	@scripts/update-modules.sh

update-ci: FORCE

	@$(GLUON_ENV) scripts/update-ci.sh

GLUON_TARGETS :=

define GluonTarget

gluon_target := $(1)$$(if $(2),-$(2))

GLUON_TARGETS += $$(gluon_target)

GLUON_TARGET_$$(gluon_target)_BOARD := $(1)

GLUON_TARGET_$$(gluon_target)_SUBTARGET := $(2)

endef

define GluonModel

GLUON_$(1)_MODELS += $(3)

GLUON_$(1)_MODEL_$(3) := $(2)

endef

include $(GLUON_TARGETSDIR)/targets.mk

include $(GLUONDIR)/targets/targets.mk

include $(GLUONDIR)/targets/$(GLUON_TARGET)/profiles.mk

OPENWRTMAKE = $(MAKE) -C openwrt

BOARD := $(GLUON_TARGET_$(GLUON_TARGET)_BOARD)

override SUBTARGET := $(GLUON_TARGET_$(GLUON_TARGET)_SUBTARGET)

target_prepared_stamp := $(BOARD_BUILDDIR)/target-prepared

gluon_prepared_stamp := $(BOARD_BUILDDIR)/prepared

include $(INCLUDE_DIR)/target.mk

SUBTARGET := $(GLUON_TARGET_$(GLUON_TARGET)_SUBTARGET)

prereq: FORCE

	+$(NO_TRACE_MAKE) prereq

gluon-tools: FORCE

	+$(GLUONMAKE_EARLY) tools/sed/install

	+$(GLUONMAKE_EARLY) package/lua/host/install

prepare-tmpinfo: FORCE

	mkdir -p tmp/info

	$(_SINGLE)$(NO_TRACE_MAKE) -j1 -r -s -f include/scan.mk SCAN_TARGET="packageinfo" SCAN_DIR="package" SCAN_NAME="package" SCAN_DEPS="$(TOPDIR)/include/package*.mk $(TOPDIR)/overlay/*/*.mk" SCAN_EXTRA=""

	$(_SINGLE)$(NO_TRACE_MAKE) -j1 -r -s -f include/scan.mk SCAN_TARGET="targetinfo" SCAN_DIR="target/linux" SCAN_NAME="target" SCAN_DEPS="profiles/*.mk $(TOPDIR)/include/kernel*.mk $(TOPDIR)/include/target.mk" SCAN_DEPTH=2 SCAN_EXTRA="" SCAN_MAKEOPTS="TARGET_BUILD=1"

	for type in package target; do \

		f=tmp/.$${type}info; t=tmp/.config-$${type}.in; \

		[ "$$t" -nt "$$f" ] || ./scripts/metadata.pl $${type}_config "$$f" > "$$t" || { rm -f "$$t"; echo "Failed to build $$t"; false; break; }; \

	done

	./scripts/metadata.pl package_mk tmp/.packageinfo > tmp/.packagedeps || { rm -f tmp/.packagedeps; false; }

	touch $(TOPDIR)/tmp/.build

feeds: FORCE

	rm -rf $(TOPDIR)/package/feeds

	mkdir $(TOPDIR)/package/feeds

	[ ! -f $(GLUON_SITEDIR)/modules ] || . $(GLUON_SITEDIR)/modules && for feed in $$GLUON_SITE_FEEDS; do ln -s ../../../packages/$$feed $(TOPDIR)/package/feeds/$$feed; done

	. $(GLUONDIR)/modules && for feed in $$GLUON_FEEDS; do ln -s ../../../packages/$$feed $(TOPDIR)/package/feeds/$$feed; done

	+$(GLUONMAKE_EARLY) prepare-tmpinfo

config: FORCE

	( \

		cat $(GLUONDIR)/include/config $(GLUONDIR)/targets/$(GLUON_TARGET)/config; \

		echo '$(patsubst %,CONFIG_PACKAGE_%=m,$(sort $(filter-out -%,$(GLUON_DEFAULT_PACKAGES) $(GLUON_SITE_PACKAGES) $(PROFILE_PACKAGES))))' \

			| sed -e 's/ /\n/g'; \

	) > .config

	+$(NO_TRACE_MAKE) defconfig OPENWRT_BUILD=0

prepare-target: FORCE

	mkdir -p $(GLUON_OPENWRTDIR)

	for dir in build_dir dl staging_dir tmp; do \

		mkdir -p $(GLUON_ORIGOPENWRTDIR)/$$dir; \

define CheckTarget

	if [ -z '$(BOARD)' ]; then

		echo 'Please set GLUON_TARGET to a valid target. Gluon supports the following targets:'

		for target in $(GLUON_TARGETS); do

			echo " * $$target"

		done

	for link in build_dir config Config.in dl include Makefile package rules.mk scripts staging_dir target tmp toolchain tools; do \

		ln -sf $(GLUON_ORIGOPENWRTDIR)/$$link $(GLUON_OPENWRTDIR); \

	done

	+$(GLUONMAKE_EARLY) feeds

	+$(GLUONMAKE_EARLY) gluon-tools

	+$(GLUONMAKE) config

	touch $(target_prepared_stamp)

$(target_prepared_stamp):

	+$(GLUONMAKE_EARLY) prepare-target

maybe-prepare-target: $(target_prepared_stamp)

$(BUILD_DIR)/.prepared: Makefile

	@mkdir -p $$(dirname $@)

	@touch $@

$(toolchain/stamp-install): $(tools/stamp-install)

$(package/stamp-compile): $(package/stamp-cleanup)

clean: FORCE

	+$(SUBMAKE) clean

	rm -f $(gluon_prepared_stamp)

dirclean: FORCE

	+$(SUBMAKE) dirclean

	rm -rf $(GLUON_BUILDDIR)

export MD5SUM := $(GLUONDIR)/scripts/md5sum.sh

export SHA512SUM := $(GLUONDIR)/scripts/sha512sum.sh

download: FORCE

	+$(SUBMAKE) tools/download

	+$(SUBMAKE) toolchain/download

	+$(SUBMAKE) package/download

	+$(SUBMAKE) target/download

toolchain: $(toolchain/stamp-install) $(tools/stamp-install)

include $(INCLUDE_DIR)/kernel.mk

kernel: FORCE

	+$(NO_TRACE_MAKE) -C $(TOPDIR)/target/linux/$(BOARD) -f $(GLUONDIR)/include/Makefile.target $(LINUX_DIR)/.image TARGET_BUILD=1

	+$(NO_TRACE_MAKE) -C $(TOPDIR)/target/linux/$(BOARD) -f $(GLUONDIR)/include/Makefile.target $(LINUX_DIR)/.modules TARGET_BUILD=1

packages: $(package/stamp-compile)

	$(_SINGLE)$(SUBMAKE) -r package/index

prepare-image: FORCE

	rm -rf $(BOARD_KDIR)

	mkdir -p $(BOARD_KDIR)

	cp $(KERNEL_BUILD_DIR)/vmlinux $(KERNEL_BUILD_DIR)/vmlinux.elf $(BOARD_KDIR)/

	+$(SUBMAKE) -C $(TOPDIR)/target/linux/$(BOARD)/image -f $(GLUONDIR)/include/Makefile.image prepare KDIR="$(BOARD_KDIR)"

prepare: FORCE

	@$(STAGING_DIR_HOST)/bin/lua $(GLUONDIR)/packages/gluon/gluon/gluon-core/files/usr/lib/lua/gluon/site_config.lua \

		|| (echo 'Your site configuration did not pass validation.'; false)

		exit 1

	fi

endef

	mkdir -p $(GLUON_IMAGEDIR) $(BOARD_BUILDDIR)

	echo 'src packages file:../openwrt/bin/$(BOARD)/packages' > $(BOARD_BUILDDIR)/opkg.conf

define CheckSite

	if ! GLUON_SITEDIR='$(GLUON_SITEDIR)' GLUON_SITE_CONFIG='$(1).conf' $(LUA) -e 'assert(dofile("scripts/site_config.lua")(os.getenv("GLUON_SITE_CONFIG")))'; then

		echo 'Your site configuration ($(1).conf) did not pass validation'

		exit 1

	fi

endef

	+$(GLUONMAKE) toolchain

	+$(GLUONMAKE) kernel

	+$(GLUONMAKE) packages

	+$(GLUONMAKE) prepare-image

list-targets: FORCE

	@for target in $(GLUON_TARGETS); do

		echo "$$target"

	done

	echo "$(GLUON_RELEASE)" > $(gluon_prepared_stamp)

lint: lint-editorconfig lint-lua lint-sh

$(gluon_prepared_stamp):

	+$(GLUONMAKE) prepare

lint-editorconfig: FORCE

	@scripts/lint-editorconfig.sh

lint-lua: FORCE

	@scripts/lint-lua.sh

include $(INCLUDE_DIR)/package-ipkg.mk

lint-sh: FORCE

	@scripts/lint-sh.sh

# override variables from rules.mk

PACKAGE_DIR = $(GLUON_OPENWRTDIR)/bin/$(BOARD)/packages

PROFILE_BUILDDIR = $(BOARD_BUILDDIR)/$(PROFILE)

PROFILE_KDIR = $(PROFILE_BUILDDIR)/kernel

BIN_DIR = $(PROFILE_BUILDDIR)/images

LUA := openwrt/staging_dir/hostpkg/bin/lua

TMP_DIR = $(PROFILE_BUILDDIR)/tmp

TARGET_DIR = $(PROFILE_BUILDDIR)/root

$(LUA):

	+@

IMAGE_PREFIX = gluon-$(GLUON_SITE_CODE)-$$(cat $(gluon_prepared_stamp))

	scripts/module_check.sh

OPKG:= \

  IPKG_TMP="$(TMP_DIR)/ipkgtmp" \

  IPKG_INSTROOT="$(TARGET_DIR)" \

  IPKG_CONF_DIR="$(TMP_DIR)" \

  IPKG_OFFLINE_ROOT="$(TARGET_DIR)" \

  $(STAGING_DIR_HOST)/bin/opkg \

	-f $(BOARD_BUILDDIR)/opkg.conf \

	--cache $(TMP_DIR)/dl \

	--offline-root $(TARGET_DIR) \

	--force-postinstall \

	--add-dest root:/ \

	--add-arch all:100 \

	--add-arch $(ARCH_PACKAGES):200

	$(GLUON_ENV) scripts/basic_openwrt_config.sh > openwrt/.config

	$(OPENWRTMAKE) defconfig

	$(OPENWRTMAKE) tools/install

	$(OPENWRTMAKE) package/lua/host/compile

EnableInitscript = ! grep -q '\#!/bin/sh /etc/rc.common' $(1) || bash ./etc/rc.common $(1) enable

config: $(LUA) FORCE

	+@

enable_initscripts: FORCE

	cd $(TARGET_DIR) && ( export IPKG_INSTROOT=$(TARGET_DIR); \

		$(foreach script,$(wildcard $(TARGET_DIR)/etc/init.d/*), \

			$(call EnableInitscript,$(script)); \

		) : \

	scripts/module_check.sh

	$(CheckTarget)

	$(foreach conf,site $(patsubst $(GLUON_SITEDIR)/%.conf,%,$(wildcard $(GLUON_SITEDIR)/domains/*.conf)),\

		$(call CheckSite,$(conf)); \

	)

	$(OPENWRTMAKE) prepare-tmpinfo

	$(GLUON_ENV) $(LUA) scripts/target_config.lua > openwrt/.config

	$(OPENWRTMAKE) defconfig

	$(GLUON_ENV) $(LUA) scripts/target_config_check.lua

# Generate package list

$(eval $(call merge-lists,INSTALL_PACKAGES,DEFAULT_PACKAGES GLUON_DEFAULT_PACKAGES GLUON_SITE_PACKAGES GLUON_$(PROFILE)_DEFAULT_PACKAGES GLUON_$(PROFILE)_SITE_PACKAGES))

package_install: FORCE

	$(OPKG) update

	$(OPKG) install $(PACKAGE_DIR)/libc_*.ipk

	$(OPKG) install $(PACKAGE_DIR)/kernel_*.ipk

container: FORCE

	@scripts/container.sh

	$(OPKG) install $(INSTALL_PACKAGES)

	+$(GLUONMAKE) enable_initscripts

	rm -f $(TARGET_DIR)/usr/lib/opkg/lists/* $(TARGET_DIR)/tmp/opkg.lock

all: config

	+@

	$(GLUON_ENV) $(LUA) scripts/clean_output.lua

	$(OPENWRTMAKE)

	$(GLUON_ENV) $(LUA) scripts/copy_output.lua

ifeq ($(GLUON_OPKG_CONFIG),1)

include $(INCLUDE_DIR)/version.mk

endif

clean download: config

	+@$(OPENWRTMAKE) $@

opkg_config: FORCE

	cp $(GLUON_OPENWRTDIR)/package/system/opkg/files/opkg.conf $(TARGET_DIR)/etc/opkg.conf

	for d in base luci packages routing telephony management oldpackages; do \

		echo "src/gz %n_$$d %U/$$d" >> $(TARGET_DIR)/etc/opkg.conf; \

dirclean: FORCE

	+@

	[ -e openwrt/.config ] || $(OPENWRTMAKE) defconfig

	$(OPENWRTMAKE) dirclean

	rm -rf $(GLUON_TMPDIR) $(GLUON_OUTPUTDIR)

manifest: $(LUA) FORCE

	@

	[ '$(GLUON_AUTOUPDATER_BRANCH)' ] || (echo 'Please set GLUON_AUTOUPDATER_BRANCH to create a manifest.'; false)

	echo '$(GLUON_PRIORITY)' | grep -qE '^([0-9]*\.)?[0-9]+$$' || (echo 'Please specify a numeric value for GLUON_PRIORITY to create a manifest.'; false)

	scripts/module_check.sh

	(

		export $(GLUON_ENV)

		echo 'BRANCH=$(GLUON_AUTOUPDATER_BRANCH)'

		echo "DATE=$$($(LUA) scripts/rfc3339date.lua)"

		echo 'PRIORITY=$(GLUON_PRIORITY)'

		echo

		for target in $(GLUON_TARGETS); do

			$(LUA) scripts/generate_manifest.lua "$$target"

		done

	$(VERSION_SED) $(TARGET_DIR)/etc/opkg.conf

image: FORCE

	rm -rf $(TARGET_DIR) $(BIN_DIR) $(TMP_DIR) $(PROFILE_KDIR)

	mkdir -p $(TARGET_DIR) $(BIN_DIR) $(TMP_DIR) $(TARGET_DIR)/tmp $(GLUON_IMAGEDIR)/factory $(GLUON_IMAGEDIR)/sysupgrade

	cp -r $(BOARD_KDIR) $(PROFILE_KDIR)

	+$(GLUONMAKE) package_install

	+$(GLUONMAKE) opkg_config GLUON_OPKG_CONFIG=1

	$(call Image/mkfs/prepare)

	$(_SINGLE)$(NO_TRACE_MAKE) -C $(TOPDIR)/target/linux/$(BOARD)/image install TARGET_BUILD=1 IB=1 IMG_PREFIX=gluon \

		PROFILE="$(PROFILE)" KDIR="$(PROFILE_KDIR)" TARGET_DIR="$(TARGET_DIR)" BIN_DIR="$(BIN_DIR)" TMP_DIR="$(TMP_DIR)"

	$(foreach model,$(GLUON_$(PROFILE)_MODELS), \

		rm -f $(GLUON_IMAGEDIR)/factory/gluon-*-$(model).bin && \

		rm -f $(GLUON_IMAGEDIR)/sysupgrade/gluon-*-$(model)-sysupgrade.bin && \

		\

		cp $(BIN_DIR)/gluon-$(GLUON_$(PROFILE)_MODEL_$(model))-factory.bin $(GLUON_IMAGEDIR)/factory/$(IMAGE_PREFIX)-$(model).bin && \

		cp $(BIN_DIR)/gluon-$(GLUON_$(PROFILE)_MODEL_$(model))-sysupgrade.bin $(GLUON_IMAGEDIR)/sysupgrade/$(IMAGE_PREFIX)-$(model)-sysupgrade.bin && \

	) :

image/%: $(gluon_prepared_stamp)

	+$(GLUONMAKE) image PROFILE="$(patsubst image/%,%,$@)" V=s$(OPENWRT_VERBOSE)

call_image/%: FORCE

	+$(GLUONMAKE) $(patsubst call_image/%,image/%,$@)

images: $(patsubst %,call_image/%,$(PROFILES)) ;

manifest: FORCE

	mkdir -p $(GLUON_IMAGEDIR)/sysupgrade

	(cd $(GLUON_IMAGEDIR)/sysupgrade && \

		echo 'BRANCH=$(GLUON_BRANCH)' && \

		echo 'DATE=$(shell $(STAGING_DIR_HOST)/bin/lua $(GLUONDIR)/scripts/rfc3339date.lua)' && \

		echo 'PRIORITY=$(GLUON_PRIORITY)' && \

		echo && \

		($(foreach profile,$(PROFILES), \

			$(foreach model,$(GLUON_$(profile)_MODELS), \

				for file in gluon-*-'$(model)-sysupgrade.bin'; do \

					[ -e "$$file" ] && echo \

						'$(model)' \

						"$$(echo "$$file" | sed -n -r -e 's/^gluon-$(call regex-escape,$(GLUON_SITE_CODE))-(.*)-$(call regex-escape,$(model))-sysupgrade\.bin$$/\1/p')" \

						"$$($(SHA512SUM) "$$file")" \

						"$$file" && break; \

				done; \

			) \

		) :) \

	) > $(GLUON_IMAGEDIR)/sysupgrade/$(GLUON_BRANCH).manifest

.PHONY: all images prepare clean gluon-tools

	) > 'tmp/$(GLUON_AUTOUPDATER_BRANCH).manifest.tmp'

endif

	mkdir -p '$(GLUON_IMAGEDIR)/sysupgrade'

	mv 'tmp/$(GLUON_AUTOUPDATER_BRANCH).manifest.tmp' '$(GLUON_IMAGEDIR)/sysupgrade/$(GLUON_AUTOUPDATER_BRANCH).manifest'

FORCE: ;

.PHONY: FORCE

.NOTPARALLEL:

.ONESHELL:

README.md

+59
−30

Original line number
Diff line number
Diff line

Documentation (incomplete at this time, contribute if you can!) may be found at

http://gluon.readthedocs.org/

[![Build Gluon](https://github.com/freifunk-gluon/gluon/actions/workflows/build-gluon.yml/badge.svg?branch=main)](https://github.com/freifunk-gluon/gluon/actions/workflows/build-gluon.yml)

[![License](https://img.shields.io/badge/License-BSD%202--Clause-orange.svg)](https://opensource.org/license/bsd-2-clause/)

[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/freifunk-gluon/gluon?sort=semver)](https://github.com/freifunk-gluon/gluon/releases/latest)

# Gluon

Gluon is a firmware framework to build preconfigured OpenWrt images for public mesh networks.

## Overview

Gluon provides an easy-to-use firmware for a public, decentral WLAN and/or wire based mesh network.

Common network capable devices, like smartphones, laptops or desktop PCs can connect to the mesh network and communicate over it, without the need of passwords for access and without the need of installing special software.

Additionally, internet access and merging mesh clouds can be accomplished over a WAN through VPN connected gateways.

Gluon's features include:

* a decentral mesh network

* easy configuration mode for less techy users

* community-specific technical settings and customizations through a common site.conf and site.mk

* ecdsa signature-based autoupdater

* node status web page

* publication of node information + statistics through respondd

* a variety of preconfigured mesh and VPN protocols:

Supported mesh protocols:

* batman-adv (BATMAN IV fully, BATMAN V partially)

* OLSRv2 (partially)

Supported protocols for node-to-node connections:

* WLAN: 802.11s (with forwarding disabled)

* WAN: VPNs via fastd and Wireguard

* LAN: via VXLAN

## Getting started

We have a huge amount of documentation over at https://gluon.readthedocs.io/.

If you're new to Gluon and ready to get your feet wet, have a look at the

[Getting Started Guide](http://gluon.readthedocs.org/en/latest/user/getting_started.html).

[Getting Started Guide](https://gluon.readthedocs.io/en/latest/user/getting_started.html).

**Gluon IRC channel: `#gluon` in [hackint](http://hackint.org/)**

Gluon's developers frequent an IRC chatroom at [#gluon](ircs://irc.hackint.org/#gluon)

on [hackint](https://hackint.org/). There is also a [webchat](https://chat.hackint.org/?join=gluon)

that allows for uncomplicated access from within your browser. This channel is also available as a bridged Matrix Room at [#gluon:hackint.org](https://matrix.to/#/#gluon:hackint.org).

## Use a release!

## Issues & Feature requests

Please refrain from using the master branch for anything else but development purposes!

Use the most recent release instead. You can list all relaseses by running `git branch -a`

and switch to one by running `git checkout v2014.3;make update`.

Before opening an issue, make sure to check whether any existing issues

(open or closed) match. If you're suggesting a new feature, drop by on IRC or

our mailinglist to discuss it first.

If you're using the autoupdater, do not autoupdate nodes with anything but releases.

If you upgrade using random master commits the nodes *will break* eventually.

We maintain a [Roadmap](https://github.com/freifunk-gluon/gluon/wiki/Roadmap) for

the future development of Gluon.

## Mailinglist (mostly for announcements)

## Use a release!

I can handle administrative requests automatically. Please

do not send them to the list address! Instead, send

your message to the correct command address:

Please refrain from using the `main` branch for anything else but development purposes!

Use the most recent release instead. You can list all releases by running `git tag`

and switch to one by running `git checkout v2023.2.5 && make update`.

For help and a description of available commands, send a message to:

If you're using the autoupdater, do not autoupdate nodes with anything but releases.

If you upgrade using random main commits the nodes *might break* eventually.

    gluon-help@luebeck.freifunk.net

## Mailinglist

To subscribe to the list, send a message to:

    gluon-subscribe@luebeck.freifunk.net

    gluon+subscribe@luebeck.freifunk.net

To remove your address from the list, just send a message to

the address in the `List-Unsubscribe` header of any list

message. If you haven't changed addresses since subscribing,

you can also send a message to:

    gluon-unsubscribe@luebeck.freifunk.net

or for the digest to:

    gluon-digest-unsubscribe@luebeck.freifunk.net

If you need to get in touch with the human owner of this list,

please send a message to:

     gluon-owner@luebeck.freifunk.net

Please include a FORWARDED list message with ALL HEADERS intact

to make it easier to help you.

    gluon+unsubscribe@luebeck.freifunk.net

contrib/actions/free-runner-space.sh0 → 100755

+23
−0

Original line number
Diff line number
Diff line

#!/usr/bin/env bash

# For a List of pre-installed packages on the runner image see

# https://github.com/actions/runner-images/tree/main?tab=readme-ov-file#available-images

echo "Disk space before cleanup"

df -h

# Remove packages not required to run the Gluon build CI

sudo apt-get -y remove \

	dotnet-* \

	firefox \

	google-chrome-stable \

	kubectl \

	microsoft-edge-stable \

	temurin-*-jdk

# Remove Android SDK tools

sudo rm -rf /usr/local/lib/android

echo "Disk space after cleanup"

df -h

contrib/actions/generate-target-filters.py0 → 100755

+54
−0

Original line number
Diff line number
Diff line

#!/usr/bin/env python3

# Update target filters using

#   make update-ci

import re

import os

import sys

import json

# these changes trigger rebuilds on all targets

common = [

    ".github/workflows/build-gluon.yml",

    "modules",

    "Makefile",

    "patches/**",

    "scripts/**",

    "targets/generic",

    "targets/targets.mk",

]

# these changes are only built on x86-64

extra = [

    "contrib/ci/minimal-site/**",

    "package/**"

]

_filter = dict()

# INCLUDE_PATTERN matches:

# include '...'

# include "..."

# include("...")

# include('...')

INCLUDE_PATTERN = "^\\s*include *\\(? *[\"']([^\"']+)[\"']"

# construct filters map from stdin

for target in sys.stdin:

    target = target.strip()

    _filter[target] = [

        f"targets/{target}"

    ] + common

    target_file = os.path.join(os.environ['GLUON_TARGETSDIR'], target)

    with open(target_file) as f:

        includes = re.findall(INCLUDE_PATTERN, f.read(), re.MULTILINE)

        _filter[target].extend([f"targets/{i}" for i in includes])

    if target == "x86-64":

        _filter[target].extend(extra)

# print filters to stdout in json format, because json is stdlib and yaml compatible.

print(json.dumps(_filter, indent=2))

contrib/actions/run-build.sh0 → 100755

+17
−0

Original line number
Diff line number
Diff line

#!/bin/sh

set -e

export BROKEN=1

export GLUON_AUTOREMOVE=1

export GLUON_DEPRECATED=1

export GLUON_SITEDIR="contrib/ci/minimal-site"

export GLUON_TARGET="$1"

export BUILD_LOG=1

BUILD_THREADS="$(($(nproc) + 1))"

echo "Building Gluon with $BUILD_THREADS threads"

make update

make -j$BUILD_THREADS V=s

contrib/actions/show-system-info.sh0 → 100755

+16
−0

Original line number
Diff line number
Diff line

#!/usr/bin/env bash

echo "-- CPU --"

cat /proc/cpuinfo

echo "-- Memory --"

cat /proc/meminfo

echo "-- Disk --"

df -h

echo "-- Kernel --"

uname -a

echo "-- Network --"

ip addr

contrib/check-image-size.py0 → 100755

+146
−0

Original line number
Diff line number
Diff line

#!/usr/bin/env python3

import argparse

import json

import sys

from enum import Enum

# Enum Class for checking image size

class ImageSizeCheck(Enum):

    OK = "OK"

    TOO_BIG = "TOO_BIG"

    IGNORED = "IGNORED"

    UNKNOWN = "UNKNOWN"

# Some devices pad their images to IMAGE_SIZE and apply a firmware header.

# Exclude this from the image size check.

excluded_devices = [

    "tplink_cpe210-v1",

    "tplink_cpe210-v2",

    "tplink_cpe210-v3",

    "tplink_cpe220-v3",

    "tplink_cpe510-v1",

    "tplink_cpe510-v2",

    "tplink_cpe510-v3",

    "tplink_cpe710-v1",

    "tplink_wbs210-v1",

    "tplink_wbs210-v2",

    "tplink_wbs510-v1"

]

def open_json(file_path):

    with open(file_path, 'r') as f:

        return json.load(f)

def load_openwrt_profile_json(json_path):

    profiles = []

    profile_json = open_json(json_path)

    for profile_name, profile_data in profile_json["profiles"].items():

        device_profile = {

            "name": profile_name,

        }

        if "image" in profile_data.get("file_size_limits", {}):

            device_profile["max_image_size"] = profile_data["file_size_limits"]["image"]

        for image in profile_data["images"]:

            if image["type"] != "sysupgrade":

                continue

            if "size" in image:

                device_profile["image_size"] = image["size"]

        profiles.append(device_profile)

    return profiles

def check_image_size_below_limit(profile, overhead=0):

    # Skip devices that pad their images

    if profile["name"] in excluded_devices:

        return ImageSizeCheck.IGNORED

    if "max_image_size" in profile and "image_size" in profile:

        if profile["image_size"] + (overhead * 1024) > profile["max_image_size"]:

            return ImageSizeCheck.TOO_BIG

        else:	

            return ImageSizeCheck.OK

    return ImageSizeCheck.UNKNOWN

def print_github_actions_warning(message):

    print('::warning::{}'.format(message))

if __name__ == '__main__':

    parser = argparse.ArgumentParser(description='Check image size of OpenWrt profiles')

    parser.add_argument(

        'profile_json',

        help='Path to profile.json',

        nargs='+'

    )

    parser.add_argument(

        '--github-actions',

        help='Generate warnings for use with GitHub Actions',

        action='store_true'

    )

    parser.add_argument(

        '--overhead',

        type=int,

        help='Additional size to add to the image size in kilobyte',

        default=0

    )

    args = parser.parse_args()

    if args.profile_json is None:

        print('Error: profile.json not specified')

        sys.exit(1)

    # Load all profile.json files

    profiles = []

    for profile_file in args.profile_json:

        profiles.extend(load_openwrt_profile_json(profile_file))

    # Initialize results with all available ImageSizeCheck values

    results = {}

    for check_result in ImageSizeCheck:

        results[check_result] = []

    for profile in profiles:

        check_result = check_image_size_below_limit(profile, args.overhead)

        results[check_result].append(profile)

    for check_result, profiles in results.items():

        if len(profiles) == 0:

            continue

        # Group by result type for GitHub Actions

        if args.github_actions:

            print('::group::{}'.format(check_result.value))

        for profile in profiles:

            if check_result == ImageSizeCheck.TOO_BIG:

                msg = 'Image size of profile {} is too big ({} > {})'.format(

                    profile["name"],

                    profile["image_size"] + (args.overhead * 1024),

                    profile["max_image_size"])

                if args.github_actions:

                    print_github_actions_warning(msg)

                else:

                    print("Warning: {}".format(msg))

            elif check_result == ImageSizeCheck.UNKNOWN:

                msg = 'Image size of profile {} is unknown'.format(

                    profile["name"])

                print(msg)

            elif check_result == ImageSizeCheck.IGNORED:

                msg = 'Image size of profile {} is ignored (Image size {})'.format(

                    profile["name"], profile.get("image_size", "unknown"))

                print(msg)

            else:

                msg = 'Image size of profile {} is OK ({} < {})'.format(

                    profile["name"], 

                    profile["image_size"] + (args.overhead * 1024),

                    profile["max_image_size"])

                print(msg)

contrib/ci/minimal-site/i18n0 → 120000

+1
−0

Original line number
Diff line number
Diff line

../../../docs/site-example/i18n/

 No newline at end of file

contrib/ci/minimal-site/image-customization.lua0 → 100644

+16
−0

Original line number
Diff line number
Diff line

features {

	'autoupdater',

	'ebtables-filter-multicast',

	'ebtables-filter-ra-dhcp',

	'ebtables-limit-arp',

	'mesh-batman-adv-15',

	'mesh-vpn-fastd',

	'respondd',

	'status-page',

	'web-advanced',

	'web-wizard',

}

if not device_class('tiny') then

	features {'wireless-encryption-wpa3'}

end

contrib/ci/minimal-site/modules0 → 120000

+1
−0

Original line number
Diff line number
Diff line

../../../docs/site-example/modules

 No newline at end of file

contrib/ci/minimal-site/site.conf0 → 100644

+180
−0

Original line number
Diff line number
Diff line

-- This is an example site configuration

--

-- Take a look at the documentation located at

-- https://gluon.readthedocs.io/ for details.

--

-- This configuration will not work as is. You're required to make

-- community specific changes to it!

{

  -- Used for generated hostnames, e.g. freifunk-abcdef123456. (optional)

  -- hostname_prefix = 'freifunk-',

  -- Name of the community.

  site_name = 'Continuous Integration',

  -- Shorthand of the community.

  site_code = 'ci',

  -- 32 bytes of random data, encoded in hexadecimal

  -- This data must be unique among all sites and domains!

  -- Can be generated using: echo $(hexdump -v -n 32 -e '1/1 "%02x"' </dev/urandom)

  domain_seed = 'e9608c4ff338b920992d629190e9ff11049de1dfc3f299eac07792dfbcda341c',

  -- Prefixes used within the mesh.

  -- prefix6 is required, prefix4 can be omitted if next_node.ip4

  -- is not set.

  prefix4 = '10.0.0.0/20',

  prefix6 = 'fd::/64',

  -- Timezone of your community.

  -- See https://openwrt.org/docs/guide-user/base-system/system_configuration#time_zones

  timezone = 'CET-1CEST,M3.5.0,M10.5.0/3',

  -- List of NTP servers in your community.

  -- Must be reachable using IPv6!

  --  ntp_servers = {'1.ntp.services.ffxx'},

  -- Wireless regulatory domain of your community.

  regdom = 'DE',

  -- Wireless configuration for 2.4 GHz interfaces.

  wifi24 = {

    -- Wireless channel.

    channel = 1,

    -- ESSIDs used for client network.

    ap = {

      ssid = 'gluon-ci-ssid',

      -- disabled = true, -- (optional)

      -- Configuration for a backward compatible OWE network below.

      owe_ssid = 'owe.gluon-ci-ssid', -- (optional - SSID for OWE client network)

      owe_transition_mode = true, -- (optional - enables transition-mode - requires ssid as well as owe_ssid)

    },

    mesh = {

      -- Adjust these values!

      id = 'ueH3uXjdp', -- usually you don't want users to connect to this mesh-SSID, so use a cryptic id that no one will accidentally mistake for the client WiFi

      mcast_rate = 12000,

      -- disabled = true, -- (optional)

    },

  },

  -- Wireless configuration for 5 GHz interfaces.

  -- This should be equal to the 2.4 GHz variant, except

  -- for channel.

  wifi5 = {

    channel = 44,

    outdoor_chanlist = '100-140',

    ap = {

      ssid = 'gluon-ci-ssid',

    },

    mesh = {

      -- Adjust these values!

      id = 'ueH3uXjdp',

      mcast_rate = 12000,

    },

  },

  mesh = {

    vxlan = true,

    batman_adv = {

      routing_algo = 'BATMAN_IV',

    },

  },

  -- The next node feature allows clients to always reach the node it is

  -- connected to using a known IP address.

  next_node = {

    -- anycast IPs of all nodes

    -- name = { 'nextnode.location.community.example.org', 'nextnode', 'nn' },

    ip4 = '10.0.0.1',

    ip6 = 'fd::1',

  },

  -- Options specific to routing protocols (optional)

  -- mesh = {

    -- Options specific to the batman-adv routing protocol (optional)

    -- batman_adv = {

      -- Gateway selection class (optional)

      -- The default class 20 is based on the link quality (TQ) only,

      -- class 1 is calculated from both the TQ and the announced bandwidth

      -- gw_sel_class = 1,

    -- },

  -- },

  mesh_vpn = {

    -- enabled = true,

    fastd = {

      -- Refer to https://fastd.readthedocs.io/en/latest/ to better understand

      -- what these options do.

      -- List of crypto-methods to use.

      methods = {'salsa2012+umac'},

      mtu = 1312,

      -- configurable = true,

      -- syslog_level = 'warn',

      groups = {

        backbone = {

          -- Limit number of connected peers to reduce bandwidth.

          limit = 1,

          -- List of peers.

          peers = {

          },

          -- Optional: nested peer groups

          -- groups = {

            -- backbone_sub = {

              -- ...

            -- },

          -- ...

          -- },

        },

        -- Optional: additional peer groups, possibly with other limits

        -- backbone2 = {

          -- ...

        -- },

      },

    },

    bandwidth_limit = {

      -- The bandwidth limit can be enabled by default here.

      enabled = false,

      -- Default upload limit (kbit/s).

      egress = 200,

      -- Default download limit (kbit/s).

      ingress = 3000,

    },

  },

  autoupdater = {

    -- Default branch (optional), can be overridden by setting GLUON_AUTOUPDATER_BRANCH when building.

    -- Set GLUON_AUTOUPDATER_ENABLED to enable the autoupdater by default for newly installed nodes.

    branch = 'stable',

    -- List of branches. You may define multiple branches.

    branches = {

      stable = {

        name = 'stable',

        -- List of mirrors to fetch images from. IPv6 required!

        mirrors = {'http://1.updates.services.ffhl/stable/sysupgrade'},

        -- Number of good signatures required.

        -- Have multiple maintainers sign your build and only

        -- accept it when a sufficient number of them have

        -- signed it.

        good_signatures = 0,

        -- List of public keys of maintainers.

        pubkeys = {

        },

      },

    },

  },

}

contrib/ci/minimal-site/site.mk0 → 120000

+1
−0

Original line number
Diff line number
Diff line

../../../docs/site-example/site.mk

 No newline at end of file

contrib/ci/olsr-site/i18n0 → 120000

+1
−0

Original line number
Diff line number
Diff line

../minimal-site/i18n

 No newline at end of file

contrib/ci/olsr-site/image-customization.lua0 → 100644

+20
−0

Original line number
Diff line number
Diff line

features {

	'autoupdater',

	'ebtables-filter-multicast',

	'ebtables-filter-ra-dhcp',

	'ebtables-limit-arp',

	'mesh-olsrd',

	'mesh-vpn-fastd',

	'respondd',

	'status-page',

	'web-advanced',

	'web-wizard',

}

packages {

	'iwinfo',

}

if not device_class('tiny') then

	features {'wireless-encryption-wpa3'}

end

contrib/ci/olsr-site/modules0 → 120000

+1
−0

Original line number
Diff line number
Diff line

../minimal-site/modules

 No newline at end of file

contrib/ci/olsr-site/site.conf0 → 100644

+176
−0

Original line number
Diff line number
Diff line

-- This is an example site configuration

--

-- Take a look at the documentation located at

-- https://gluon.readthedocs.io/ for details.

--

-- This configuration will not work as is. You're required to make

-- community specific changes to it!

{

  -- Used for generated hostnames, e.g. freifunk-abcdef123456. (optional)

  -- hostname_prefix = 'freifunk-',

  -- Name of the community.

  site_name = 'Continuous Integration',

  -- Shorthand of the community.

  site_code = 'ci',

  -- 32 bytes of random data, encoded in hexadecimal

  -- This data must be unique among all sites and domains!

  -- Can be generated using: echo $(hexdump -v -n 32 -e '1/1 "%02x"' </dev/urandom)

  domain_seed = 'e9608c4ff338b920992d629190e9ff11049de1dfc3f299eac07792dfbcda341c',

  -- Prefixes used by clients within the mesh.

  -- prefix6 is required, prefix4 can be omitted if next_node.ip4

  -- is not set.

  prefix6 = 'fdff:cafe:cafe:cafe::/64',

  -- Prefixes used by nodes within the mesh

  node_prefix6 = 'fdff:cafe:cafe:cafe::/64',

  -- Timezone of your community.

  -- See https://openwrt.org/docs/guide-user/base-system/system_configuration#time_zones

  timezone = 'CET-1CEST,M3.5.0,M10.5.0/3',

  -- List of NTP servers in your community.

  -- Must be reachable using IPv6!

  --  ntp_servers = {'1.ntp.services.ffxx'},

  -- Wireless regulatory domain of your community.

  regdom = 'DE',

  -- Wireless configuration for 2.4 GHz interfaces.

  wifi24 = {

    -- Wireless channel.

    channel = 1,

    -- ESSIDs used for client network.

    ap = {

      ssid = 'gluon-ci-ssid',

      -- disabled = true, -- (optional)

      -- Configuration for a backward compatible OWE network below.

      owe_ssid = 'owe.gluon-ci-ssid', -- (optional - SSID for OWE client network)

      owe_transition_mode = true, -- (optional - enables transition-mode - requires ssid as well as owe_ssid)

    },

    mesh = {

      -- Adjust these values!

      id = 'ueH3uXjdp', -- usually you don't want users to connect to this mesh-SSID, so use a cryptic id that no one will accidentally mistake for the client WiFi

      mcast_rate = 12000,

      -- disabled = true, -- (optional)

    },

  },

  -- Wireless configuration for 5 GHz interfaces.

  -- This should be equal to the 2.4 GHz variant, except

  -- for channel.

  wifi5 = {

    channel = 44,

    outdoor_chanlist = '100-140',

    ap = {

      ssid = 'gluon-ci-ssid',

      -- disabled = true, -- (optional)

      -- Configuration for a backward compatible OWE network below.

      owe_ssid = 'owe.gluon-ci-ssid', -- (optional - SSID for OWE client network)

      owe_transition_mode = true, -- (optional - enables transition-mode - requires ssid as well as owe_ssid)

    },

    mesh = {

      -- Adjust these values!

      id = 'ueH3uXjdp',

      mcast_rate = 12000,

    },

  },

  -- The next node feature allows clients to always reach the node it is

  -- connected to using a known IP address.

  next_node = {

    -- anycast IPs of all nodes

    name = { 'nextnode.location.community.example.org', 'nextnode', 'nn' },

    ip4 = '10.0.0.1',

    ip6 = 'fd::1',

  },

  -- Options specific to routing protocols (optional)

  mesh = {

    vxlan = true,

    olsrd = {},

  },

  mesh_vpn = {

    -- enabled = true,

    fastd = {

      -- Refer to https://fastd.readthedocs.io/en/latest/ to better understand

      -- what these options do.

      -- List of crypto-methods to use.

      methods = {'salsa2012+umac'},

      mtu = 1312,

      -- configurable = true,

      -- syslog_level = 'warn',

      groups = {

        backbone = {

          -- Limit number of connected peers to reduce bandwidth.

          limit = 1,

          -- List of peers.

          peers = {

          },

          -- Optional: nested peer groups

          -- groups = {

            -- backbone_sub = {

              -- ...

            -- },

          -- ...

          -- },

        },

        -- Optional: additional peer groups, possibly with other limits

        -- backbone2 = {

          -- ...

        -- },

      },

    },

    bandwidth_limit = {

      -- The bandwidth limit can be enabled by default here.

      enabled = false,

      -- Default upload limit (kbit/s).

      egress = 200,

      -- Default download limit (kbit/s).

      ingress = 3000,

    },

  },

  autoupdater = {

    -- Default branch (optional), can be overridden by setting GLUON_AUTOUPDATER_BRANCH when building.

    -- Set GLUON_AUTOUPDATER_ENABLED to enable the autoupdater by default for newly installed nodes.

    branch = 'stable',

    -- List of branches. You may define multiple branches.

    branches = {

      stable = {

        name = 'stable',

        -- List of mirrors to fetch images from. IPv6 required!

        mirrors = {'http://1.updates.services.ffhl/stable/sysupgrade'},

        -- Number of good signatures required.

        -- Have multiple maintainers sign your build and only

        -- accept it when a sufficient number of them have

        -- signed it.

        good_signatures = 0,

        -- List of public keys of maintainers.

        pubkeys = {

        },

      },

    },

  },

}

contrib/ci/olsr-site/site.mk0 → 100644

+29
−0

Original line number
Diff line number
Diff line

##	gluon site.mk makefile example

##	DEFAULT_GLUON_RELEASE

#		version string to use for images

#		gluon relies on

#			opkg compare-versions "$1" '>>' "$2"

#		to decide if a version is newer or not.

DEFAULT_GLUON_RELEASE := 0.6+exp$(shell date '+%Y%m%d')

# Variables set with ?= can be overwritten from the command line

##	GLUON_RELEASE

#		call make with custom GLUON_RELEASE flag, to use your own release version scheme.

#		e.g.:

#			$ make images GLUON_RELEASE=23.42+5

#		would generate images named like this:

#			gluon-ff%site_code%-23.42+5-%router_model%.bin

GLUON_RELEASE ?= $(DEFAULT_GLUON_RELEASE)

# Default priority for updates.

GLUON_PRIORITY ?= 0

# Region code required for some images; supported values: us eu

GLUON_REGION ?= eu

# Languages to include

GLUON_LANGS ?= en de

contrib/depdot.sh0 → 100755

+58
−0

Original line number
Diff line number
Diff line

#!/usr/bin/env bash

# Script to output the dependency graph of Gluon's packages

# Limitations:

#  * Doesn't show dependencies through virtual packages correctly

set -e

shopt -s nullglob

pushd "$(dirname "$0")/.." >/dev/null

escape_name() {

	echo -n "_$1" | tr -c '[:alnum:]' _

}

print_node() {

	echo "$(escape_name "$1") [label=\"$1\", shape=box];"

}

print_dep() {

	echo "$(escape_name "$1") -> $(escape_name "$2");"

}

print_package() {

	local package="$1" depends="$2"

	# shellcheck disable=SC2086

	set -- $depends

	print_node "$package"

	for dep in "$@"; do

		print_node "$dep"

		print_dep "$package" "$dep"

	done

}

make -C openwrt -s prepare-tmpinfo

echo 'digraph G {'

cat ./openwrt/tmp/info/.packageinfo-feeds_gluon_base_* | while read -r key value; do

	case "$key" in

	'Package:')

		package="$value"

		;;

	'Depends:')

		depends="${value//+/}"

		;;

	'@@')

		print_package "$package" "$depends"

		;;

	esac

done | sort -u

popd >/dev/null

echo '}'

contrib/docker/Dockerfile0 → 100644

+47
−0

Original line number
Diff line number
Diff line

FROM debian:bookworm-slim

ARG TARGETOS

ARG TARGETARCH

ARG DEBIAN_FRONTEND=noninteractive

RUN apt-get update && apt-get install -y --no-install-recommends \

    build-essential \

    ca-certificates \

    clang \

    ecdsautils \

    file \

    gawk \

    git \

    libelf-dev \

    libncurses5-dev \

    libnss-unknown \

    libssl-dev \

    llvm \

    lua-check \

    openssh-client \

    python3 \

    python3-dev \

    python3-pyelftools \

    python3-setuptools \

    qemu-utils \

    rsync \

    shellcheck \

    swig \

    time \

    unzip \

    wget \

    zlib1g-dev \

    && apt-get clean \

    && rm -rf /var/lib/apt/lists/*

RUN mkdir /tmp/ec &&\

    wget -O /tmp/ec/ec-${TARGETOS}-${TARGETARCH}.tar.gz https://github.com/editorconfig-checker/editorconfig-checker/releases/download/2.7.0/ec-${TARGETOS}-${TARGETARCH}.tar.gz &&\

    tar -xvzf /tmp/ec/ec-${TARGETOS}-${TARGETARCH}.tar.gz &&\

    mv bin/ec-${TARGETOS}-${TARGETARCH} /usr/local/bin/editorconfig-checker &&\

    rm -rf /tmp/ec

RUN useradd -m -d /gluon -u 100 -g 100 -o gluon

USER gluon

VOLUME /gluon

WORKDIR /gluon

contrib/i18n-scan.pl0 → 100755

+128
−0

Original line number
Diff line number
Diff line

#!/usr/bin/perl

use strict;

use warnings;

use Text::Balanced qw(extract_bracketed extract_delimited extract_tagged);

@ARGV >= 1 || die "Usage: $0 <source directory>\n";

my %stringtable;

sub dec_lua_str

{

	my $s = shift;

	$s =~ s/[\s\n]+/ /g;

	$s =~ s/\\n/\n/g;

	$s =~ s/\\t/\t/g;

	$s =~ s/\\(.)/$1/g;

	$s =~ s/^ //;

	$s =~ s/ $//;

	return $s;

}

sub dec_tpl_str

{

	my $s = shift;

	$s =~ s/-$//;

	$s =~ s/[\s\n]+/ /g;

	$s =~ s/^ //;

	$s =~ s/ $//;

	$s =~ s/\\/\\\\/g;

	return $s;

}

if( open F, "find @ARGV -type f '(' -name '*.html' -o -name '*.lua' ')' |" )

{

	while( defined( my $file = readline F ) )

	{

		chomp $file;

		if( open S, "< $file" )

		{

			local $/ = undef;

			my $raw = <S>;

			close S;

			my $text = $raw;

			while( $text =~ s/ ^ .*? (?:translate|translatef|_) [\n\s]* \( /(/sgx )

			{

				( my $code, $text ) = extract_bracketed($text, q{('")});

				$code =~ s/\\\n/ /g;

				$code =~ s/^\([\n\s]*//;

				$code =~ s/[\n\s]*\)$//;

				my $res = "";

				my $sub = "";

				if( $code =~ /^['"]/ )

				{

					while( defined $sub )

					{

						( $sub, $code ) = extract_delimited($code, q{'"}, q{\s*(?:\.\.\s*)?});

						if( defined $sub && length($sub) > 2 )

						{

							$res .= substr $sub, 1, length($sub) - 2;

						}

						else

						{

							undef $sub;

						}

					}

				}

				elsif( $code =~ /^(\[=*\[)/ )

				{

					my $stag = quotemeta $1;

					my $etag = $stag;

					$etag =~ s/\[/]/g;

					( $res ) = extract_tagged($code, $stag, $etag);

					$res =~ s/^$stag//;

					$res =~ s/$etag$//;

				}

				$res = dec_lua_str($res);

				$stringtable{$res}++ if $res;

			}

			$text = $raw;

			while( $text =~ s/ ^ .*? <% -? [:_] /<%/sgx )

			{

				( my $code, $text ) = extract_tagged($text, '<%', '%>');

				if( defined $code )

				{

					$code = dec_tpl_str(substr $code, 2, length($code) - 4);

					$stringtable{$code}++;

				}

			}

		}

	}

	close F;

}

if( open C, "| msgcat -" )

{

	printf C "msgid \"\"\nmsgstr \"Content-Type: text/plain; charset=UTF-8\"\n\n";

	foreach my $key ( sort keys %stringtable )

	{

		if( length $key )

		{

			$key =~ s/"/\\"/g;

			printf C "msgid \"%s\"\nmsgstr \"\"\n\n", $key;

		}

	}

	close C;

}

contrib/lsupgrade.sh0 → 100755

+48
−0

Original line number
Diff line number
Diff line

#!/usr/bin/env bash

set -e

# Script to list all upgrade scripts in a clear manner

# Limitations:

#  * Does only show scripts of packages whose `files'/`luasrc' directories represent the whole image filesystem (which are all Gluon packages)

SUFFIX1=files/lib/gluon/upgrade

SUFFIX2=luasrc/lib/gluon/upgrade

shopt -s nullglob

if tty -s <&1; then

	RED="$(echo -e '\x1b[01;31m')"

	GREEN="$(echo -e '\x1b[01;32m')"

	BLUE="$(echo -e '\x1b[01;34m')"

	RESET="$(echo -e '\x1b[0m')"

else

	RED=

	GREEN=

	BLUE=

	RESET=

fi

pushd "$(dirname "$0")/.." >/dev/null

find ./package packages -name Makefile | grep -v '^packages/packages/' | while read -r makefile; do

	dir="$(dirname "$makefile")"

	pushd "$dir" >/dev/null

	repo="$(dirname "$dir" | cut -d/ -f 2)"

	dirname="$(dirname "$dir" | cut -d/ -f 3-)"

	package="$(basename "$dir")"

	for file in "${SUFFIX1}"/* "${SUFFIX2}"/*; do

		basename="$(basename "${file}")"

		suffix="$(dirname "${file}")"

		printf "%s\t%s\n" "${basename}" "${BLUE}${repo}${RESET}/${dirname}${dirname:+/}${RED}${package}${RESET}/${suffix}/${GREEN}${basename}${RESET}"

	done

	popd >/dev/null

done | sort | cut -f2-

popd >/dev/null

contrib/push_pkg.sh0 → 100755

+149
−0

Original line number
Diff line number
Diff line

#!/bin/sh

set -e

topdir="$(realpath "$(dirname "${0}")/../openwrt")"

# defaults to qemu run script

ssh_host=localhost

build_only=0

preserve_config=1

print_help() {

	echo "$0 [OPTIONS] PACKAGE_DIR [PACKAGE_DIR] ..."

	echo ""

	echo " -h          print this help"

	echo " -r HOST     use a remote machine as target machine. By default if this"

	echo "             option is not given, push_pkg.sh will use a locally"

	echo "             running qemu instance started by run_qemu.sh."

	echo " -p PORT     use PORT as ssh port (default is 22)"

	echo " -b          build only, do not push"

	echo " -P          do not preserve /etc/config. By default, if a package"

	echo "             defines a config file in /etc/config, this config file"

	echo "             will be preserved. If you specify this flag, the package"

	echo "             default will be installed instead."

	echo ""

	echo ' To change gluon variables, run e.g. "make config GLUON_MINIFY=0"'

	echo ' because then the gluon logic will be triggered, and openwrt/.config'

	echo ' will be regenerated. The variables from openwrt/.config are already'

	echo ' automatically used for this script.'

	echo

}

while getopts "p:r:hbP" opt

do

	case $opt in

		P) preserve_config=0;;

		p) ssh_port="${OPTARG}";;

		r) ssh_host="${OPTARG}"; [ -z "$ssh_port" ] && ssh_port=22;;

		b) build_only=1;;

		h) print_help; exit 0;;

		*) ;;

	esac

done

shift $(( OPTIND - 1 ))

[ -z "$ssh_port" ] && ssh_port=2223

if [ "$build_only" -eq 0 ]; then

	remote_info=$(ssh -p "${ssh_port}" "root@${ssh_host}" '

		source /etc/os-release

		printf "%s\\t%s\\n" "$OPENWRT_BOARD" "$OPENWRT_ARCH"

	')

	REMOTE_OPENWRT_BOARD="$(echo "$remote_info" | cut -f 1)"

	REMOTE_OPENWRT_ARCH="$(echo "$remote_info" | cut -f 2)"

	# check target

	if ! grep -q "CONFIG_TARGET_ARCH_PACKAGES=\"${REMOTE_OPENWRT_ARCH}\"" "${topdir}/.config"; then

		echo "Configured OpenWrt Target is not matching with the target machine!" 1>&2

		echo

		printf "%s" "    Configured architecture: " 1>&2

		grep "CONFIG_TARGET_ARCH_PACKAGES" "${topdir}/.config" 1>&2

		echo "Target machine architecture: ${REMOTE_OPENWRT_ARCH}" 1>&2

		echo 1>&2

		echo "To switch the local with the run with the corresponding GLUON_TARGET:"  1>&2

		echo "  make GLUON_TARGET=... config" 1>&2

		exit 1

	fi

fi

if [ $# -lt 1 ]; then

	echo ERROR: Please specify a PACKAGE_DIR. For example:

	echo

	echo " \$ $0 package/gluon-core"

	exit 1

fi

while [ $# -gt 0 ]; do

	pkgdir="$1"; shift

	echo "Package: ${pkgdir}"

	if ! [ -f "${pkgdir}/Makefile" ]; then

		echo "ERROR: ${pkgdir} does not contain a Makefile"

		exit 1

	fi

	if ! grep -q BuildPackage "${pkgdir}/Makefile"; then

		echo "ERROR: ${pkgdir}/Makefile does not contain a BuildPackage command"

		exit 1

	fi

	opkg_packages="$(make TOPDIR="${topdir}" -C "${pkgdir}" DUMP=1 | awk '/^Package: / { print $2 }')"

	search_package() {

		find "$2" -name "$1_*.ipk" -printf '%f\n'

	}

	make TOPDIR="${topdir}" -C "${pkgdir}" clean

	make TOPDIR="${topdir}" -C "${pkgdir}" compile

	if [ "$build_only" -eq 1 ]; then

		continue

	fi

	# IPv6 addresses need brackets around the ${ssh_host} for scp!

	if echo "${ssh_host}" | grep -q :; then

		BL=[

		BR=]

	fi

	for pkg in ${opkg_packages}; do

		for feed in "${topdir}/bin/packages/${REMOTE_OPENWRT_ARCH}/"*/ "${topdir}/bin/targets/${REMOTE_OPENWRT_BOARD}/packages/"; do

			printf "%s" "searching ${pkg} in ${feed}: "

			filename=$(search_package "${pkg}" "${feed}")

			if [ -n "${filename}" ]; then

				echo found!

				break

			else

				echo not found

			fi

		done

		if [ "$preserve_config" -eq 0 ]; then

			opkg_flags=" --force-maintainer"

		fi

		# shellcheck disable=SC2029

		if [ -n "$filename" ]; then

			scp -O -P "${ssh_port}" "$feed/$filename" "root@${BL}${ssh_host}${BR}:/tmp/${filename}"

			ssh -p "${ssh_port}" "root@${ssh_host}" "

				set -e

				echo Running opkg:

				opkg install --force-reinstall ${opkg_flags} '/tmp/${filename}'

				rm '/tmp/${filename}'

				gluon-reconfigure

			"

		else

			# Some packages (e.g. procd-seccomp) seem to contain BuildPackage commands

			# which do not generate *.ipk files. Till this point, I am not aware why

			# this is happening. However, dropping a warning if the corresponding

			# *.ipk is not found (maybe due to other reasons as well), seems to

			# be more reasonable than aborting. Before this commit, the command

			# has failed.

			echo "Warning: ${pkg}*.ipk not found! Ignoring." 1>&2

		fi

	done

done

contrib/run_qemu.sh0 → 100755

+15
−0

Original line number
Diff line number
Diff line

#!/bin/sh

# Note: You can exit the qemu instance by first pressing "CTRL + a" then "c".

#       Then you enter the command mode of qemu and can exit by typing "quit".

qemu-system-x86_64 \

	-d 'cpu_reset' \

	-enable-kvm \

	-gdb tcp::1234 \

	-nographic \

	-netdev user,id=wan,hostfwd=tcp::2223-10.0.2.15:22 \

	-device virtio-net-pci,netdev=wan,addr=0x06,id=nic1 \

	-netdev user,id=lan,hostfwd=tcp::6080-192.168.1.1:80,hostfwd=tcp::2222-192.168.1.1:22,net=192.168.1.100/24 \

	-device virtio-net-pci,netdev=lan,addr=0x05,id=nic2 \

	"$@"

contrib/sign.sh

+48
−21

Original line number
Diff line number
Diff line

#!/bin/sh

if [ $# -eq 0 -o "-h" = "$1" -o "-help" = "$1" -o "--help" = "$1" ]; then

set -e

if [ $# -ne 2 ] || [ "-h" = "$1" ] || [ "--help" = "$1" ] || [ ! -r "$1" ] || [ ! -r "$2" ]; then

	cat <<EOHELP

Usage: $0 <secret> <manifest>

sign.sh adds lines to a manifest to indicate the approval

of the integrity of the firmware as required for automated

updates. The first argument <secret> references a file harboring

the private key of a public-private key pair of a developer

that referenced by its public key in the site configuration.

The script may be performed multiple times to the same document

to indicate an approval by multiple developers.

See also

Source

Target

Files

Some changes are not shown.