Compare revisions

Changes are shown as if the source revision was being merged into the target revision. Learn more about comparing revisions.

Source

Target

Show changes

Only incoming changes from source

Include changes to target after source was created

Commits on Source 5236

426a868b Basic build system
Feb 11, 2013
d297ec7b Further flesh out build system
Feb 11, 2013
d8cba8e6 Update packages_gluon
Feb 11, 2013
adad83c1 Improve feed handling
Feb 11, 2013
37f8df9a Various fixes and enhancements
Feb 12, 2013
98c798e2 Add README
Feb 12, 2013
9e41e269 Don't use tabs to indent README
Feb 12, 2013
9af13d63 Add support for hardware profiles with different module sets
Feb 12, 2013
845a032d Enable IPv6 module
Feb 12, 2013
70e7c7d2 Reprepare OpenWRT by default on make
Feb 13, 2013
76585fa0 Add firewall to default packages
Feb 13, 2013
4a06f022 Update packages_gluon
Feb 13, 2013
783797a3 Fix parallel build of images target
Feb 13, 2013
1850b4ed Update packages_gluon
Feb 13, 2013
bc7c4c70 Create package index and do other image preparations just once
Feb 13, 2013
3c7ab928 Use separate root directories for different profiles
Feb 13, 2013
a6e3cd32 Create rootfs images for different profiles in separate directories
Feb 13, 2013
102c0bd1 Allow parallel build of different profiles
Feb 13, 2013
593e90d1 Use nice OpenWRT make output
Feb 17, 2013
9ac754a9 Fix gluon_prepared_stamp reference
Feb 17, 2013
bae01b74 Prevent calling make with unsupported targets, fix build of individual images
Feb 17, 2013
50a91212 Remove some redundancies from the makefile
Feb 17, 2013
e237cc56 Fix gluon_prepared_stamp recipe
Feb 17, 2013
3e923d0e Build kernel compatible to the official OpenWRT release
Feb 17, 2013
b2b4ac90 Fix verbosity setting in image build
Feb 18, 2013
441d9911 Clean up initscript activation code
Feb 18, 2013
a8acbf7c Extended package list cascading
Feb 18, 2013
c31afa7b Update packages_gluon
Feb 18, 2013
97d637b1 Only enable initscripts of non-base packages when they are explicitly installed
Feb 19, 2013
59c4aef9 Simplify builder Makefile
Feb 19, 2013
5460b64a Fix parallel build
Feb 19, 2013
e2eb424b Nicer output for profile builds
Feb 19, 2013
34f4be30 Fix site profile package selection
Feb 19, 2013
ed552b52 Correctly handle OpenWRT profile package list (with negative selection)
Feb 20, 2013
1db485b9 Add GPL2 LICENSE
Feb 24, 2013
9206ed2c Fix single-image build with GNU Make 3.81
Mar 7, 2013
747701e3 Move around some files, remove a layer of make invocation
Apr 4, 2013
c62e7a86 Update OpenWRT submodules
Apr 4, 2013
70cd82ec Remove unneeded parts of the toplevel.mk
Apr 4, 2013
94dd4dde Make feed update a bit less hacky
Apr 5, 2013
38b3a9f0 Simplify service activation
Apr 5, 2013
bd8d51d6 Merge builder Makefile into main Makefile
Apr 5, 2013
6694b7b1 Add some information about 'make clean' to the README
Apr 5, 2013
f17e2c7a Fix build when feeds.conf doesn't exist
Apr 6, 2013
01a574fa Fix build without .config
Apr 6, 2013
c8761831 Update OpenWRT repositories
Sep 10, 2013
3e9e95a2 Add TODO file
Sep 10, 2013
be7b917b Fix routing feed
Sep 11, 2013
3071e8dd Fix package list generation
Sep 11, 2013
63c58476 Fix build with GNU make 3.81
Sep 12, 2013
88233955 Fix previous makefile patch
Sep 12, 2013
af2a826e Fix parallel build
Sep 24, 2013
8ea5e9ef Include luci as a submodule
Sep 24, 2013
d312f68b Fix some more make warnings regarding parallel build
Sep 24, 2013
4dedadd7 Update routing packages
Sep 24, 2013
fc6ad3d6 More package updates
Sep 28, 2013
35a20e25 Add config generator scripts
Sep 28, 2013
cdb55cb1 Update gluon packages
Sep 28, 2013
cb7e0b55 Update gluon packages
Sep 28, 2013
2111cd98 Update gluon packages
Sep 28, 2013
12e1d1c8 Update gluon packages
Sep 28, 2013
38563ffa Update gluon packages
Sep 28, 2013
73f3572c Abort when the generator fails (e.g. because of syntax errors in the config)
Sep 29, 2013
5daaeb62 Rename site.pl to site.conf
Sep 29, 2013
6000eee2 Update gluon packages
Sep 29, 2013
addc51d2 Update gluon packages
Sep 29, 2013
0e7d6315 Update gluon packages
Sep 29, 2013
00b47f0a Update gluon packages
Sep 29, 2013
60f0a8ac Update gluon packages
Sep 29, 2013
e1f8225c Update gluon packages
Sep 29, 2013
60095e2a Update gluon packages
Sep 30, 2013
31da7125 Ignore lists in site config
Sep 30, 2013
b72ffb1b configure: use tabs instead of spaces
Sep 30, 2013
2f919846 Split up configure script
Sep 30, 2013
7d247175 Update gluon packages
Sep 30, 2013
d56e8603 Update gluon packages
Sep 30, 2013
08f35737 Update gluon packages
Oct 1, 2013
c3c4c795 Update openwrt
Oct 1, 2013
f12c0ed8 Update gluon packages
Oct 2, 2013
eb3f3c55 Update gluon packages
Oct 2, 2013
8332ac50 Update LICENSE
Oct 2, 2013
1db175e0 Update gluon packages
Oct 2, 2013
39042045 Update gluon packages
Oct 3, 2013
f973df2e Update gluon packages
Oct 3, 2013
d88fd8f8 Update gluon packages
Oct 3, 2013
7087e591 Fix inclusion of profile-specific packages from OpenWRT
Oct 8, 2013
4e1f3d4f Set the opkg repo to a working value
Oct 8, 2013
a1e7d456 Make the config variable setting code a bit nicer
Oct 8, 2013
1c170c65 Update kernel config to 12.09 release
Oct 8, 2013
65054dc3 Update gluon packages
Oct 8, 2013
bfcc3d91 Move package submodules to packages/
Oct 9, 2013
a1505817 Add more hardware profiles (TODO: test on every model)
Oct 9, 2013
3a9a90be Update gluon packages
Oct 9, 2013
45313051 Update gluon packages
Oct 11, 2013
a31408ed Update gluon packages
Nov 28, 2013
bae3a80d Update gluon packages
Nov 28, 2013
1cc03828 Less ambiguous README.md, mention build reqs
Dec 15, 2013
508e9e93 Remove submodules
Dec 28, 2013
3ddc0777 Add make target to check out modules
Dec 28, 2013
1117cc39 Add patch and unpatch targets
Dec 28, 2013

5,136 additional commits have been omitted to prevent performance issues.

Some changes are not shown.

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

.ecrc

0 → 100644

+3 −0

Original line number	Diff line number	Diff line
		{
		"Exclude": ["docs/_build"]
		}

.editorconfig

0 → 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.md

0 → 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.yml

0 → 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.yml

0 → 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.yml

0 → 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.yml

0 → 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.yml

0 → 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.yml

0 → 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.yml

0 → 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.yml

0 → 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.yml

0 → 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.yml

0 → 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.yml

0 → 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.yml

0 → 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

0 → 100644

+10 −0

Original line number	Diff line number	Diff line
		*~
		/openwrt
		/output
		/site
		/tmp
		/packages
		.bash_history
		.subversion
		.wget-hsts
		/.scmversion

.luacheckrc

0 → 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.yaml

0 → 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.md

0 → 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

0 → 100644

+37 −0

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 individual files or subtrees.

		Copyright (c) Project Gluon
		All rights reserved.

		Redistribution and use in source and binary forms, with or without
		modification, are permitted provided that the following conditions are met:

		1. Redistributions of source code must retain the above copyright notice,
		this list of conditions and the following disclaimer.
		2. Redistributions in binary form must reproduce the above copyright notice,
		this list of conditions and the following disclaimer in the documentation
		and/or other materials provided with the distribution.

		THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
		AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
		IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
		DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
		FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
		DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
		SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
		CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
		OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
		OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.


		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
		* packages/luci

Makefile

0 → 100644

+248 −0

Original line number	Diff line number	Diff line
		all:

		LC_ALL:=C
		LANG:=C
		export LC_ALL LANG

		.SHELLFLAGS = -ec

		# 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

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

		GLUON_SITEDIR ?= site
		$(eval $(call mkabspath,GLUON_SITEDIR))

		ifeq ($(realpath $(GLUON_SITEDIR)/site.mk),)
		$(error No site configuration was found. Please check out a site configuration to $(GLUON_SITEDIR))
		endif

		include $(GLUON_SITEDIR)/site.mk

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

		GLUON_DEPRECATED ?= 0

		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

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

		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

		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

		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

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

		show-release:
		@echo '$(GLUON_RELEASE)'


		update: FORCE
		@
		export $(GLUON_ENV)
		scripts/update.sh
		scripts/patch.sh
		scripts/feeds.sh

		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

		include $(GLUON_TARGETSDIR)/targets.mk


		OPENWRTMAKE = $(MAKE) -C openwrt

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


		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
		exit 1
		fi
		endef

		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

		list-targets: FORCE
		@for target in $(GLUON_TARGETS); do
		echo "$$target"
		done

		lint: lint-editorconfig lint-lua lint-sh

		lint-editorconfig: FORCE
		@scripts/lint-editorconfig.sh

		lint-lua: FORCE
		@scripts/lint-lua.sh

		lint-sh: FORCE
		@scripts/lint-sh.sh


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

		$(LUA):
		+@

		scripts/module_check.sh

		$(GLUON_ENV) scripts/basic_openwrt_config.sh > openwrt/.config
		$(OPENWRTMAKE) defconfig
		$(OPENWRTMAKE) tools/install
		$(OPENWRTMAKE) package/lua/host/compile


		config: $(LUA) FORCE
		+@

		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


		container: FORCE
		@scripts/container.sh


		all: config
		+@
		$(GLUON_ENV) $(LUA) scripts/clean_output.lua
		$(OPENWRTMAKE)
		$(GLUON_ENV) $(LUA) scripts/copy_output.lua

		clean download: config
		+@$(OPENWRTMAKE) $@

		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
		) > 'tmp/$(GLUON_AUTOUPDATER_BRANCH).manifest.tmp'

		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

0 → 100644

+78 −0

Original line number	Diff line number	Diff line
		[![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](https://gluon.readthedocs.io/en/latest/user/getting_started.html).

		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).

		## Issues & Feature requests

		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.

		We maintain a [Roadmap](https://github.com/freifunk-gluon/gluon/wiki/Roadmap) for
		the future development of Gluon.

		## Use a release!

		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`.

		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.

		## Mailinglist

		To subscribe to the list, send a message to:

		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

contrib/actions/free-runner-space.sh

0 → 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.py

0 → 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 = "^\\sinclude \\(? *[\"']([^\"']+)[\"']"

		# 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.sh

0 → 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.sh

0 → 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.py

0 → 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/i18n

0 → 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.lua

0 → 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/modules

0 → 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.conf

0 → 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.mk

0 → 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/i18n

0 → 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.lua

0 → 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/modules

0 → 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.conf

0 → 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.mk

0 → 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.sh

0 → 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/Dockerfile

0 → 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.pl

0 → 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.sh

0 → 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.sh

0 → 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.sh

0 → 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

0 → 100755

+55 −0

Original line number	Diff line number	Diff line
		#!/bin/sh

		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
		* ecdsautils on https://github.com/freifunk-gluon/ecdsautils

		EOHELP
		exit 1
		fi

		SECRET="$1"

		manifest="$2"
		upper="$(mktemp)"
		lower="$(mktemp)"

		trap 'rm -f "$upper" "$lower"' EXIT

		awk 'BEGIN {
		sep = 0
		}

		/^---$/ {
		sep = 1;
		next
		}

		{
		if(sep == 0) {
		print > "'"$upper"'"
		} else {
		print > "'"$lower"'"
		}
		}' "$manifest"

		ecdsasign "$upper" < "$SECRET" >> "$lower"

		(
		cat "$upper"
		echo ---
		cat "$lower"
		) > "$manifest"

contrib/sigtest.sh

0 → 100755

+50 −0

Original line number	Diff line number	Diff line
		#!/bin/sh

		if [ $# -eq 0 ] \|\| [ "-h" = "$1" ] \|\| [ "-help" = "$1" ] \|\| [ "--help" = "$1" ]; then
		cat <<EOHELP
		Usage: $0 <public> <signed manifest>

		sigtest.sh checks if a manifest is signed by the public key <public>. There is
		no output, success or failure is indicated via the return code.

		See also:
		* ecdsautils in https://github.com/freifunk-gluon/ecdsautils
		* https://gluon.readthedocs.io/en/latest/features/autoupdater.html

		EOHELP
		exit 1
		fi

		public="$1"
		manifest="$2"
		upper="$(mktemp)"
		lower="$(mktemp)"
		ret=1

		awk 'BEGIN {
		sep = 0
		}

		/^---$/ {
		sep = 1;
		next
		}

		{
		if(sep == 0) {
		print > "'"$upper"'"
		} else {
		print > "'"$lower"'"
		}
		}' "$manifest"

		while read -r line
		do
		if ecdsaverify -s "$line" -p "$public" "$upper"; then
		ret=0
		break
		fi
		done < "$lower"

		rm -f "$upper" "$lower"
		exit $ret

docs/.gitignore

0 → 100644

+1 −0

Original line number	Diff line number	Diff line
		_build/

docs/Makefile

0 → 100644

+19 −0

Original line number	Diff line number	Diff line
		# Minimal makefile for Sphinx documentation
		#

		# You can set these variables from the command line.
		SPHINXOPTS = -W --keep-going
		SPHINXBUILD = sphinx-build
		SOURCEDIR = .
		BUILDDIR = _build

		# Put it first so that "make" without argument is like "make help".
		help:
		@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

		.PHONY: help Makefile

		# Catch-all target: route all unknown targets to Sphinx using the new
		# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
		%: Makefile
		@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/_static/css/custom.css

0 → 100644

+3 −0

Original line number	Diff line number	Diff line
		.strike {
		text-decoration: line-through;
		}

docs/conf.py

0 → 100644

+188 −0

Original line number	Diff line number	Diff line
		# -- coding: utf-8 --
		#
		# Configuration file for the Sphinx documentation builder.
		#
		# This file does only contain a selection of the most common options. For a
		# full list see the documentation:
		# http://www.sphinx-doc.org/en/master/config

		# -- Path setup --------------------------------------------------------------

		# If extensions (or modules to document with autodoc) are in another directory,
		# add these directories to sys.path here. If the directory is relative to the
		# documentation root, use os.path.abspath to make it absolute, like shown here.
		#
		# import os
		# import sys
		# sys.path.insert(0, os.path.abspath('.'))


		# -- Project information -----------------------------------------------------

		project = 'Gluon'
		copyright = 'Project Gluon'
		author = 'Project Gluon'

		# The short X.Y version
		version = '2023.2.5'
		# The full version, including alpha/beta/rc tags
		release = version


		# -- General configuration ---------------------------------------------------

		# If your documentation needs a minimal Sphinx version, state it here.
		#
		# needs_sphinx = '1.0'

		# Add any Sphinx extension module names here, as strings. They can be
		# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
		# ones.
		extensions = [
		]

		# Add any paths that contain templates here, relative to this directory.
		templates_path = ['_templates']

		# The suffix(es) of source filenames.
		# You can specify multiple suffix as a list of string:
		#
		# source_suffix = ['.rst', '.md']
		source_suffix = {'.rst': 'restructuredtext'}

		# The master toctree document.
		master_doc = 'index'

		# The language for content autogenerated by Sphinx. Refer to documentation
		# for a list of supported languages.
		#
		# This is also used if you do content translation via gettext catalogs.
		# Usually you set "language" from the command line for these cases.
		language = 'en'

		# List of patterns, relative to source directory, that match files and
		# directories to ignore when looking for source files.
		# This pattern also affects html_static_path and html_extra_path.
		exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']

		# The name of the Pygments (syntax highlighting) style to use.
		pygments_style = None

		# Don't highlight code blocks unless requested explicitly
		highlight_language = 'none'

		# Ignore links to the config mode, as well as anchors on on hackint, which are
		# used to mark channel names and do not exist. Regular links are not effected.
		linkcheck_ignore = [
		'http://192.168.1.1',
		'https://chat.hackint.org'
		]


		# -- Options for HTML output -------------------------------------------------

		# The theme to use for HTML and HTML Help pages. See the documentation for
		# a list of builtin themes.
		#
		html_theme = 'sphinx_rtd_theme'

		# Theme options are theme-specific and customize the look and feel of a theme
		# further. For a list of options available for each theme, see the
		# documentation.
		#
		# html_theme_options = {}

		# Add any paths that contain custom static files (such as style sheets) here,
		# relative to this directory. They are copied after the builtin static files,
		# so a file named "default.css" will overwrite the builtin "default.css".
		#
		html_static_path = ['_static']

		# Custom sidebar templates, must be a dictionary that maps document names
		# to template names.
		#
		# The default sidebars (for documents that don't match any pattern) are
		# defined by theme itself. Builtin themes are using these templates by
		# default: ``['localtoc.html', 'relations.html', 'sourcelink.html',
		# 'searchbox.html']``.
		#
		# html_sidebars = {}

		# These paths are either relative to html_static_path
		# or fully qualified paths (eg. https://...)
		html_css_files = ['css/custom.css']


		# -- Options for HTMLHelp output ---------------------------------------------

		# Output file base name for HTML help builder.
		htmlhelp_basename = 'Gluondoc'


		# -- Options for LaTeX output ------------------------------------------------

		latex_elements = {
		# The paper size ('letterpaper' or 'a4paper').
		#
		# 'papersize': 'letterpaper',

		# The font size ('10pt', '11pt' or '12pt').
		#
		# 'pointsize': '10pt',

		# Additional stuff for the LaTeX preamble.
		#
		# 'preamble': '',

		# Latex figure (float) alignment
		#
		# 'figure_align': 'htbp',
		}

		# Grouping the document tree into LaTeX files. List of tuples
		# (source start file, target name, title,
		# author, documentclass [howto, manual, or own class]).
		latex_documents = [
		(master_doc, 'Gluon.tex', 'Gluon Documentation',
		'Project Gluon', 'manual'),
		]


		# -- Options for manual page output ------------------------------------------

		# One entry per manual page. List of tuples
		# (source start file, name, description, authors, manual section).
		man_pages = [
		(master_doc, 'gluon', 'Gluon Documentation',
		[author], 1)
		]


		# -- Options for Texinfo output ----------------------------------------------

		# Grouping the document tree into Texinfo files. List of tuples
		# (source start file, target name, title, author,
		# dir menu entry, description, category)
		texinfo_documents = [
		(master_doc, 'Gluon', 'Gluon Documentation',
		author, 'Gluon', 'One line description of project.',
		'Miscellaneous'),
		]


		# -- Options for Epub output -------------------------------------------------

		# Bibliographic Dublin Core info.
		epub_title = project

		# The unique identifier of the text. This can be a ISBN number
		# or the project homepage.
		#
		# epub_identifier = ''

		# A unique identification for the text.
		#
		# epub_uid = ''

		# A list of files that should not be packed into the epub file.
		epub_exclude_files = ['search.html']

docs/dev/basics.rst

0 → 100644

+85 −0

Original line number	Diff line number	Diff line
		Development Basics
		==================

		Gluon's source is kept in `git repositories`_ at GitHub.

		.. _git repositories: https://github.com/freifunk-gluon

		Bug Tracker
		-----------

		The `main repo`_ does have issues enabled.

		.. _main repo: https://github.com/freifunk-gluon/gluon

		IRC
		---

		Gluon's developers frequent the IRC chatroom `#gluon`_ on `hackint`_.
		There is a `webchat`_ that allows for easy access from within your
		web browser. You're welcome to join us!

		.. _#gluon: ircs://irc.hackint.org/#gluon
		.. _hackint: https://hackint.org/
		.. _webchat: https://chat.hackint.org/?join=gluon

		.. _working-with-repositories:

		Working with repositories
		-------------------------

		To update the repositories used by Gluon, just adjust the commit IDs in `modules` and
		rerun

		::

		make update

		`make update` also applies the patches that can be found in the directories found in
		`patches`; the resulting branch will be called `patched`, while the commit specified in `modules`
		can be referred to by the branch `base`.

		After new patches have been committed on top of the `patched` branch (or existing commits
		since the base commit have been edited or removed), the patch directories can be regenerated
		using

		::

		make update-patches

		If applying a patch fails because you have changed the base commit, the repository will be reset to the old `patched` branch
		and you can try rebasing it onto the new `base` branch yourself and after that call `make update-patches` to fix the problem.

		Always call `make update-patches` after making changes to a module repository as `make update` will overwrite your
		commits, making `git reflog` the only way to recover them!

		::

		make refresh-patches

		In order to refresh patches when updating feeds or the OpenWrt base, `make refresh-patches` applies and updates all of their patches without installing feed packages to the OpenWrt build system.

		This command speeds up the maintenance of updating OpenWrt and feeds.

		Development Guidelines
		----------------------
		Lua should be used instead of sh whenever sensible. The following criteria
		should be considered:

		- Is the script doing more than just executing external commands? if so, use Lua
		- Is the script parsing/editing json-data? If so, use Lua for speed
		- When using sh, use jsonfilter instead of json_* functions for speed

		Code formatting may sound like a topic for the pedantic, however it helps if
		the code in the project is formatted in the same way. The following basic rules
		apply:

		- use tabs instead of spaces
		- trailing whitespace characters must be eliminated
		- files need to end with a final newline
		- newlines need to have Unix line endings (lf)

		To that end we provide a ``.editorconfig`` configuration, which is supported by most
		of the editors out there.

		If you add Lua scripts to gluon, check formatting with ``luacheck``.

docs/dev/build.rst

0 → 100644

+104 −0

Original line number	Diff line number	Diff line
		Build system
		============

		This page explains internals of the Gluon build system. It is currently very
		incomplete; please contribute if you can!

		Feed management
		---------------

		Rather that relying on the feed.conf mechanism of OpenWrt directly, Gluon
		manages its feeds ("modules") using a collection of scripts. This solution was
		selected for multiple reasons:

		- Feeds lists from Gluon base and the site repository are combined
		- Patchsets are applied to downloaded feed repositories automatically

		The following variables specifically affect the feed management:

		GLUON_FEEDS
		List of base feeds; defined in file modules in Gluon base

		GLUON_SITE_FEED
		List of site feeds; defined in file modules in site config

		\_REPO, \_BRANCH, \*_COMMIT
		Git repository URL, branch and
		commit ID of the feeds to use. The branch name may be omitted; the default
		branch will be used in this case.

		GLUON_BASE_FEEDS
		Additional feed definitions to be added to feeds.conf
		verbatim. By default, this contains a reference to the Gluon base packages;
		when using the Gluon build system to build a non-Gluon system, the variable
		can be set to the empty string.

		Helper scripts
		--------------

		Several tasks of the build process have been separated from the Makefile into
		external scripts, which are stored in the scripts directory. This was done to
		ease maintenance of these scripts and the Makefile, by avoiding a lot of escaping.
		These scripts are either bash or Lua scripts that run on the build system.

		default_feeds.sh
		Defines the constant ``DEFAULT_FEEDS`` with the names of all feeds listed in
		openwrt/feeds.conf.default. This script is only used as an include by other
		scripts.

		feeds.sh
		Creates the openwrt/feeds.conf file from ``FEEDS`` and ``DEFAULT_FEEDS``. The
		feeds from ``FEEDS`` are linked to the matching subfolder of packages/ and not
		explicitly defined feeds of ``DEFAULT_FEEDS`` are setup as dummy (src-dummy).
		This openwrt/feeds.conf is used to reinstall all packages of all feeds with
		the openwrt/scripts/feeds tool.

		modules.sh
		Defines the constants ``GLUON_MODULES`` and ``FEEDS`` by reading the modules
		files of the Gluon repository root and the site configuration. The returned
		variables look like:

		- ``FEEDS``: "feedA feedB ..."
		- ``GLUON_MODULES``: "openwrt packages/feedA packages/feedB ..."

		This script is only used as an include by other scripts.

		patch.sh
		(Re-)applies the patches from the patches directory to all ``GLUON_MODULES``
		and checks out the files to the filesystem.
		This is done for each repo by:

		- creating a temporary clone of the repo to patch
		- only branch base is used
		- applying all patches via git am on top of this temporary base branch
		- this branch is named patched
		- copying the temporary clone to the openwrt (for OpenWrt Base) or
		packages (for feeds) folder
		- git fetch is used with the temporary clone as source
		- git checkout is called to update the filesystem
		- updating all git submodules

		This solution with a temporary clone ensures that the timestamps of checked
		out files are not changed by any intermediate patch steps, but only when
		updating the checkout with the final result. This avoids triggering unnecessary
		rebuilds.

		update.sh
		Sets up a working clone of the ``GLUON_MODULES`` (external repos) from the external
		source and installs it into packages/ directory. It simply tries to set the base
		branch of the cloned repo to the correct commit. If this fails it fetches the
		upstream branch and tries again to set the local base branch.

		getversion.sh
		Used to determine the version numbers of the repositories of Gluon and the
		site configuration, to be included in the built firmware images as
		/lib/gluon/gluon-version and /lib/gluon/site-version.

		By default, this uses ``git describe`` to generate a version number based
		on the last git tag. This can be overridden by putting a file called
		.scmversion into the root of the respective repositories.

		A command like ``rm -f .scmversion; echo "$(./scripts/getversion.sh .)" > .scmversion``
		can be used before applying local patches to ensure that the reported
		version numbers refer to an upstream commit ID rather than an arbitrary
		local one after ``git am``.

docs/dev/debugging.rst

0 → 100644

+51 −0

Original line number	Diff line number	Diff line
		Debugging
		=========


		.. _dev-debugging-kernel-oops:

		Kernel Oops
		-----------

		Sometimes a running Linux kernel detects an error during runtime that can't
		be corrected.
		This usually generates a stack trace that points to the location in the code
		that caused the oops.

		Linux kernels in Gluon (and OpenWrt) are stripped.
		That means they do not contain any debug symbols.
		On one hand this leads to a smaller binary and faster loading times on the
		target.
		On the other hand this means that in a case of a stack trace the unwinder
		can only print memory locations and no further debugging information.

		Gluon stores a compressed kernel with debug symbols for every target
		in the directory `output/debug/`.
		These kernels should be kept along with the images as long as the images
		are in use.
		This allows the developer to analyse a stack trace later.

		Decoding Stacktraces
		....................

		The tooling is contained in the kernel source tree in the file
		`decode_stacktrace.sh <https://github.com/torvalds/linux/blob/master/scripts/decode_stacktrace.sh>`__.
		This file and the needed source tree are available in the directory: ::

		openwrt/build_dir/target-<architecture>/linux-<architecture>/linux-<version>/

		.. note::
		Make sure to use a kernel tree that matches the version and patches
		that was used to build the kernel.
		If in doubt just re-build the images for the target.

		Some more information on how to use this tool can be found at
		`LWN <https://lwn.net/Articles/592724/>`__.

		Obtaining Stacktraces
		.....................

		On many targets stack traces can be read from the following
		location after reboot: ::

		/sys/kernel/debug/crashlog

docs/dev/hardware.rst

0 → 100644

+238 −0

Original line number	Diff line number	Diff line
		Adding hardware support
		=======================
		This page will give a short overview on how to add support
		for new hardware to Gluon.

		Hardware requirements
		---------------------
		Having an ath9k, ath10k or mt76 based WLAN adapter is highly recommended,
		although other chipsets may also work. VAP (multiple SSID) support
		with simultaneous AP + Mesh Point (802.11s) operation is required.

		Device checklist
		----------------
		The description of pull requests adding device support must include the
		`device integration checklist
		<https://github.com/freifunk-gluon/gluon/wiki/Device-Integration-checklist>`_.
		The checklist ensures that core functionality of Gluon is well supported on the
		device.

		.. _device-class-definition:

		Device classes
		--------------
		All supported hardware is categorized into "device classes". This allows to
		adjust the feature set of Gluon to the different hardware's capabilities via
		``site.mk`` without having to list individual devices.

		There are currently two devices classes defined: "standard" and "tiny". The
		"tiny" class contains all devices that do not meet the following requirements:

		- At least 7 MiB of usable firmware space
		- At least 64 MiB of RAM (128MiB for devices with ath10k radio)

		Target configuration
		--------------------
		Gluon's hardware support is based on OpenWrt's. For each supported target,
		a configuration file exists at ``targets/<target>-<subtarget>`` (or just
		``target/<target>`` for targets without subtargets) that contains all
		Gluon-specific settings for the target. The generic configuration
		``targets/generic`` contains settings that affect all targets.

		All targets must be listed in ``target/targets.mk``.

		The target configuration language is based on Lua, so Lua's syntax for variables
		and control structures can be used.

		Device definitions
		~~~~~~~~~~~~~~~~~~
		To configure a device to be built for Gluon, the ``device`` function is used.
		In the simplest case, only two arguments are passed, for example:

		.. code-block:: lua

		device('tp-link-tl-wdr3600-v1', 'tplink_tl-wdr3600-v1')

		The first argument is the device name in Gluon, which is part of the output
		image filename, and must correspond to the model string looked up by the
		autoupdater. The second argument is the corresponding device profile name in
		OpenWrt, as found in ``openwrt/target/linux/<target>/image/*``.

		A table of additional settings can be passed as a third argument:

		.. code-block:: lua

		device('ubiquiti-edgerouter-x', 'ubnt_edgerouter-x', {
		factory = false,
		packages = {'-hostapd-mini'},
		manifest_aliases = {
		'ubnt-erx',
		},
		})

		The supported additional settings are described in the following sections.

		Suffixes and extensions
		~~~~~~~~~~~~~~~~~~~~~~~
		For many targets, OpenWrt generates images with the suffixes
		``-squashfs-factory.bin`` and ``-squashfs-sysupgrade.bin``. For devices with
		different image names, is it possible to override the suffixes and extensions
		using the settings ``factory``, ``factory_ext``, ``sysupgrade`` and
		``sysupgrade_ext``, for example:

		.. code-block:: lua

		{
		factory = '-squashfs-combined',
		factory_ext = '.img.gz',
		sysupgrade = '-squashfs-combined',
		sysupgrade_ext = '.img.gz',
		}

		Only settings that differ from the defaults need to be passed. ``factory`` and
		``sysupgrade`` can be set to ``false`` when no such images exist.

		For some device types, there are multiple factory images with different
		extensions. ``factory_ext`` can be set to a table of strings to account for this
		case:

		.. code-block:: lua

		{
		factory_ext = {'.img.gz', '.vmdk', '.vdi'},
		}

		TODO: Extra images

		Aliases and manifest aliases
		~~~~~~~~~~~~~~~~~~~~~~~~~~~~
		Sometimes multiple devices exist that use the same OpenWrt images. To make it
		easier to find these images, the ``aliases`` setting can be used to define
		additional device names. Gluon will create symlinks for these names in the
		image output directory.

		.. code-block:: lua

		device('aruba-ap-303', 'aruba_ap-303', {
		factory = false,
		aliases = {'aruba-instant-on-ap11'},
		})

		The aliased name will also be added to the autoupdater manifest, allowing upgrade
		images to be found under the different name on targets that perform model name
		detection at runtime.

		It is also possible to add alternative names to the autoupdater manifest without
		creating a symlink by using ``manifest_aliases`` instead of ``aliases``, which
		should be done when the alternative name does not refer to a separate device.
		This is particularly useful to allow the autoupdater to work when the model name
		changed between Gluon versions.

		Package lists
		~~~~~~~~~~~~~
		Gluon generates lists of packages that are installed in all images based on a
		default list and the features and packages specified in the site configuration.

		In addition, OpenWrt defines additional per-device package lists. These lists
		may be modified in Gluon's device definitions, for example to include additional
		drivers and firmware, or to remove unneeded software. Packages to remove are
		prefixed with a ``-`` character.

		For many ath10k-based devices, this is used to replace the "CT" variant of
		ath10k with the mainline-based version:

		.. code-block:: lua

		local ATH10K_PACKAGES_QCA9880 = {
		'kmod-ath10k',
		'-kmod-ath10k-ct',
		'-kmod-ath10k-ct-smallbuffers',
		'ath10k-firmware-qca988x',
		'-ath10k-firmware-qca988x-ct',
		}
		device('openmesh-a40', 'openmesh_a40', {
		packages = ATH10K_PACKAGES_QCA9880,
		factory = false,
		})

		This example also shows how to define a local variable, allowing the package
		list to be reused for multiple devices.

		Device flags
		~~~~~~~~~~~~

		The settings ``class``, ``deprecated`` or ``broken`` should be set according to
		the device support status. The default values are as follows:

		.. code-block:: lua

		{
		class = 'standard',
		deprecated = false,
		broken = false,
		}

		- Device classes are described in :ref:`device-class-definition`
		- Broken devices are untested or do not meet our requirements as given by the
		device checklist
		- Deprecated devices are slated for removal in a future Gluon version due to
		hardware constraints

		Global settings
		~~~~~~~~~~~~~~~
		There is a number of directives that can be used outside of a ``device()``
		definition:

		- ``include('filename')``: Include another file with global settings
		- ``config(key, value)``: Set a config symbol in OpenWrt's ``.config``. Value
		may be a string, number, boolean, or nil. Booleans and nil are used for
		tristate symbols, where nil sets the symbol to ``m``.
		- ``try_config(key, value)``: Like ``config()``, but do not fail if setting
		the symbol is not possible (usually because its dependencies are not met)
		- ``packages { 'package1', '-package2', ... }``: Define a list of packages to
		add or remove for all devices of a target. Package lists passed to multiple
		calls of ``packages`` will be aggregated.
		- ``defaults { key = value, ... }``: Set default values for any of the
		additional settings that can be passed to ``device()``.

		Helper functions
		~~~~~~~~~~~~~~~~
		The following helpers can be used in the target configuration:

		- ``env.KEY`` allows to access environment variables
		- ``istrue(value)`` returns true if the passed string is a positive number
		(often used with ``env``, for example ``if istrue(env.GLUON_DEBUG) then ...``)

		Hardware support in packages
		----------------------------
		In addition to the target configuration files, some device-specific changes may
		be required in packages.

		gluon-core
		~~~~~~~~~~
		- ``/lib/gluon/upgrade/010-primary-mac``: Override primary MAC address selection

		Usually, the primary (label) MAC address is defined in OpenWrt's Device Trees.
		For devices or targets where this is not the case, it is possible to specify
		what interface to take the primary MAC address from in ``010-primary-mac``.

		- ``/lib/gluon/upgrade/020-interfaces``: Override LAN/WAN interface assignment

		On PoE-powered devices, the PoE input port should be "WAN".

		- ``/usr/lib/lua/gluon/platform.lua``: Contains a list of outdoor devices

		gluon-setup-mode
		~~~~~~~~~~~~~~~~
		- ``/lib/gluon/upgrade/320-setup-ifname``: Contains a list of devices that use
		the WAN port for the config mode

		On PoE-powered devices, the PoE input port should be used for the config
		mode. This is handled correctly by default for outdoor devices listed in
		``platform.lua``.

		libplatforminfo
		~~~~~~~~~~~~~~~
		When adding support for a new target to Gluon, it may be necessary to adjust
		libplatforminfo to define how autoupdater image names are derived from the
		model name.

docs/dev/mac_addresses.rst

0 → 100644

+18 −0

Original line number	Diff line number	Diff line
		MAC addresses
		=============

		Many devices don't have enough unique MAC addresses assigned by the vendor
		(in batman-adv, each mesh interface needs an own MAC address that must be unique
		mesh-wide).

		Gluon tries to solve this issue by using a hash of the primary MAC address as a
		45 bit MAC address prefix. The resulting 8 addresses are used as follows:

		* 0: client0; WAN
		* 1: mesh0
		* 2: owe0
		* 3: wan_radio0 (private WLAN); batman-adv primary address
		* 4: client1; LAN
		* 5: mesh1
		* 6: owe1
		* 7: wan_radio1 (private WLAN); mesh VPN

docs/dev/packages.rst

0 → 100644

+215 −0

Original line number	Diff line number	Diff line
		Package development
		###################

		Gluon packages are OpenWrt packages and follow the same rules described at https://openwrt.org/docs/guide-developer/packages.

		Development workflow
		====================

		When you are developing packages, it often happens that you iteratively want to deploy
		and verify the state your development. There are two ways to verify your changes:

		1)
		One way is to rebuild the complete firmware, flash it, configure it and verify your
		development then. This usually takes at least a few minutes to get your changes
		working so you can test them. Especially if you iterate a lot, this becomes tedious.

		2)
		Another way is to rebuild only the package you are currently working on and
		to deploy this package to your test system. Here not even a reboot is required.
		This makes iterating relatively fast. Your test system could be real hardware or
		even a qemu in most cases.

		Gluon provides scripts to enhance workflow 2). Here is an example illustrating
		the workflow using these scripts:

		.. code-block:: shell

		# start a local qemu instance
		contrib/run_qemu.sh output/images/factory/[...]-x86-64.img

		# apply changes to the desired package
		vi package/gluon-ebtables/files/etc/init.d/gluon-ebtables

		# rebuild and push the package to the qemu instance
		contrib/push_pkg.sh package/gluon-ebtables/

		# test your changes
		...

		# do more changes
		...

		# rebuild and push the package to the qemu instance
		contrib/push_pkg.sh package/gluon-ebtables/

		# test your changes
		...

		(and so on...)

		# see help of the script for more information
		contrib/push_pkg.sh -h
		...

		Features of ``push_pkg.sh``:

		* Works with compiled and non-compiled packages.

		* This means it can be used in the development of C-code, Lua-Code and mostly any other code.

		* Works with native OpenWrt and Gluon packages.
		* Pushes to remote machines or local qemu instances.
		* Pushes multiple packages in one call if desired.
		* Performs site.conf checks.

		Implementation details of ``push_pkg.sh``:

		* First, the script builds an opkg package using the OpenWrt build system.
		* This package is pushed to a target machine using scp:

		* By default the target machine is a locally running x86 qemu started using ``run_qemu.sh``.
		* The target machine can also be remote machine. (See the cli switch ``-r``)
		* Remote machines are not limited to a specific architecture. All architectures supported by gluon can be used as remote machines.

		* Finally opkg is used to install/update the packages in the target machine.

		* While doing this, it will not override ``/etc/config`` with package defaults by default. (See the cli switch ``-P``).
		* While doing this, opkg calls the ``check_site.lua`` from the package as post_install script to validate the ``site.conf``. This means that the ``site.conf`` of the target machine is used for this validation.

		Note that:

		* ``push_pkg.sh`` does neither build nor push dependencies of the packages automatically. If you want to update dependencies, you must explicitly specify them to be pushed.
		* If you add new packages, you must run ``make update config GLUON_TARGET=...``.
		* You can change the gluon target of the target machine via ``make config GLUON_TARGET=...``.
		* If you want to update the ``site.conf`` of the target machine, use ``push_pkg.sh package/gluon-site/``.
		* Sometimes when things break, you can heal them by compiling a package with its dependencies: ``cd openwrt; make package/gluon-ebtables/clean; make package/gluon-ebtables/compile; cd ..``.
		* You can exit qemu by pressing ``CTRL + a`` and ``c`` afterwards.

		Gluon package makefiles
		=======================

		As many packages share the same or a similar structure, Gluon provides a ``package/gluon.mk`` that
		can be included for common definitions. This file replaces OpenWrt's ``$(INCLUDE_DIR)/package.mk``;
		it is usually included as ``include ../gluon.mk`` from Gluon core packages, or as
		``include $(TOPDIR)/../package/gluon.mk`` from feeds.

		Provided macros
		***************

		* GluonBuildI18N (arguments: <source directory>)

		Converts the .po files for all enabled languages from the given source directory to
		the binary .lmo format and stores them in ``$(PKG_BUILD_DIR)/i18n``.

		* GluonInstallI18N

		Install .lmo files from ``$(PKG_BUILD_DIR)/i18n`` to ``/lib/gluon/web/i18n`` in the
		package install directory.

		* GluonSrcDiet (arguments: <source directory>, <destination directory>)

		Copies a directory tree, processing all files in it using LuaSrcDiet. The directory
		tree should only contain Lua files.

		* GluonCheckSite (arguments: <source file>)

		Intended to be used in a package postinst script. It will use the passed Lua
		snippet to verify package-specific site configuration.

		* BuildPackageGluon (replaces BuildPackage)

		Extends the Package/<name> definition with common defaults, sets the package
		install script to the common Gluon/Build/Install, and automatically creates
		a postinst script using GluonCheckSite if a ``check_site.lua`` is found in the
		package directory.

		Default build steps
		*******************

		These defaults greatly reduce the boilerplate in each package, but they can also
		be confusing because of the many implicit behaviors depending on files in the
		package directory. If any part of Gluon/Build/Compile or Gluon/Build/Install
		does not work as intended for a package, the compile and install steps can
		always be replaced or extended.

		Build/Compile is set to Gluon/Build/Compile by default, which will

		* run OpenWrt standard default commands (Build/Compile/Default) if a ``src/Makefile``
		or ``src/CMakeLists.txt`` is found
		* run GluonSrcDiet on all files in the ``luasrc`` directory
		* run GluonBuildI18N if a ``i18n`` directory is found

		Package/<name> defaults to Gluon/Build/Install for packages defined using
		BuildPackageGluon, which will

		* copy all files from ``$(PKG_INSTALL_DIR)`` into the package if ``$(PKG_INSTALL)`` is 1
		* copy all files from ``files`` into the package
		* copy all Lua files built from ``luasrc`` into the package
		* installs ``$(PKG_BUILD_DIR)/respondd.so`` to ``/usr/lib/respondd/$(PKG_NAME).so`` if ``src/respondd.c`` exists
		* installs compiled i18n .lmo files

		Feature flags
		=============

		Feature flags provide a convenient way to define package selections without
		making it necessary to list each package explicitly. The list of features to
		enable for a Gluon build is determined by the evaluated image-customization.lua file
		in the root-directory of the Site repository.

		The main feature flag definition file is ``package/features``, but each package
		feed can provide additional definitions in a file called ``features`` at the root
		of the feed repository.

		Each flag $flag will include the package the name gluon-$flag by default.
		The feature definition file can modify the package selection by adding or removing
		packages when certain combinations of flags are set.

		Feature definitions use Lua syntax. Two basic functions are defined:

		* feature(name, pkgs): Defines a new feature. feature() expects a feature
		(flag) name and a list of packages to add or remove when the feature is
		enabled.

		* Defining a feature using feature replaces the default definition of
		just including gluon-$flag.
		* A package is removed when the package name is prefixed with a ``-`` (after
		the opening quotation mark).

		* when(expr, pkgs): Adds or removes packages when a given logical expression
		of feature flags is satisfied.

		* expr is a logical expression composed of feature flag names (each prefixed
		with an underscore before the opening quotation mark), logical operators
		(and, or, not) and parentheses.
		* Referencing a feature flag in expr has no effect on the default handling
		of the flag. When no feature() entry for a flag exists, it will still
		add gluon-$flag by default.
		* pkgs is handled as for feature().

		Example::

		feature('web-wizard', {
		'gluon-config-mode-hostname',
		'gluon-config-mode-geo-location',
		'gluon-config-mode-contact-info',
		'gluon-config-mode-outdoor',
		})

		when(_'web-wizard' and _'mesh-vpn-fastd' or _'mesh-vpn-wireguard'), {
		'gluon-config-mode-mesh-vpn',
		})

		feature('no-radvd', {
		'-gluon-radvd',
		})


		This will

		* disable the inclusion of the (non-existent) packages gluon-web-wizard and gluon-no-radvd when their
		corresponding feature flags are evaluated as selected in the image-customization.lua file
		* enable four additional config mode packages when the web-wizard feature is enabled
		* enable gluon-config-mode-mesh-vpn when both web-wizard and one
		of mesh-vpn-fastd and mesh-vpn-wireguard are enabled
		* disable the gluon-radvd package when gluon-no-radvd is enabled

docs/dev/site_library.rst

0 → 100644

+36 −0

Original line number	Diff line number	Diff line
		gluon.site library
		==================

		The gluon.site library allows convenient access to the site configuration
		from Lua scripts. Example:

		.. code-block:: lua

		local site = require 'gluon.site'
		print(site.wifi24.ap.ssid())

		The site object in this example does not directly represent the site.conf data structure;
		instead, it is wrapped in a way that makes it more convenient to access deeply nested elements.
		To access the underlying values, they must be unwrapped using the function call notation
		(the ``()`` after ``site.wifi24.ap.ssid`` in the example).

		The wrapper objects have two advantages over simple Lua tables:

		* Accessing non-existing values is never an error: ``site.wifi24.ap.ssid()`` will simply
		return nil if ``site.wifi24`` or ``site.wifi24.ap`` do not exist
		* Default values: A default value can be passed to the unwrapping function call:

		.. code-block:: lua

		print(site.wifi24.ap.ssid('Default'))

		will return 'Default' instead of nil when the value is unset.

		Note that nil values and unset values are equivalent in Lua.

		A simple way to access the whole site configuration as a simple table
		is to unwrap the top-level site object:

		.. code-block:: lua

		local site_table = site()

docs/dev/upgrade.rst

0 → 100644

+41 −0

Original line number	Diff line number	Diff line
		Upgrade scripts
		===============

		Basics
		------

		After each sysupgrade (including the initial installation), Gluon will execute all scripts
		under ``/lib/gluon/upgrade``. These scripts' filenames usually begin with a 3-digit number
		specifying the order of execution. Note that the script files need to be executable.

		To get an overview of the ordering of all scripts of all packages, the helper script ``contrib/lsupgrade.sh``
		in the Gluon repository can be used, which will print all upgrade scripts' filenames and directories. If executed
		on a TTY, the filename will be highlighted in green, the repository in blue and the package in red.

		Best practices
		--------------

		* Most upgrade scripts are written in Lua. This allows using lots of helper functions provided
		by Gluon, e.g. to access the site configuration or edit UCI configuration files.

		* Whenever possible, scripts shouldn't check if they are running for the first time, but just edit configuration
		files to achieve a valid configuration (without overwriting configuration changes made by the user where desirable).
		This allows using the same code to create the initial configuration and upgrade configurations on upgrades.

		* If it is unavoidable to run different code during the initial installation, the ``sysconfig.gluon_version`` variable
		can be checked. This variable is ``nil`` during the initial installation and contains the previously installed Gluon
		version otherwise.

		Script ordering
		---------------

		These are some guidelines for the script numbers:

		* ``0xx``: Basic ``sysconfig`` setup
		* ``1xx``: Basic system setup (including basic network configuration)
		* ``2xx``: Wireless setup
		* ``3xx``: Advanced network and system setup
		* ``4xx``: Extended network and system setup (e.g. mesh VPN and next-node)
		* ``5xx``: Miscellaneous (everything not fitting into any other category)
		* ``6xx`` .. ``8xx``: Currently unused
		* ``9xx``: Upgrade finalization

docs/dev/uplink.rst

0 → 100644

+55 −0

Original line number	Diff line number	Diff line
		Uplink support
		==============

		As the WAN port of a node will be connected to a user's private network, it
		is essential that the node only uses the WAN when it is absolutely necessary.
		There are two cases in which the WAN port is used:

		* Mesh VPN (package ``gluon-mesh-vpn-fastd``)
		* DNS to resolve the VPN servers' addresses (package ``gluon-wan-dnsmasq``)

		After the VPN connection has been established, the node should be able to reach
		the mesh's DNS servers and use these for all other name resolution.

		If a device has only a single Ethernet port (or group of ports), it will be
		used as an uplink port even when it is not labeled as "WAN" by default. This
		behavior can be controlled using the ``interfaces.single.default_roles``
		site.conf option. It is also possible to alter the interface assignment after
		installation by modifying ``/etc/config/gluon`` and running
		``gluon-reconfigure``.

		Routing tables
		~~~~~~~~~~~~~~
		As a node may get IPv6 default routes both over the WAN and the mesh, Gluon
		uses two routing tables for IPv6. As all normal traffic should go over the mesh,
		the mesh routes are added to the default table (table 0). All routes on the WAN interface
		are put into table 1 (see ``/lib/gluon/upgrade/110-network`` in ``gluon-core``).

		There is also an ip -6 rule which routes all IPv6 traffic with a packet mark with the
		bit 1 set though table 1.


		libpacketmark
		~~~~~~~~~~~~~
		libpacketmark is a library which can be loaded with ``LD_PRELOAD`` and will set the packet mark of all
		sockets created by a process in accordance with the ``LIBPACKETMARK_MARK`` environment variable. This allows setting
		the packet mark for processes which don't support this themselves. The process must run as root (or at least
		with ``CAP_NET_ADMIN``) for this to work.

		Unfortunately there's no nice way to set the packet mark via iptables for outgoing packets. The iptables will
		run after the packet has been created, to even when the packet mark is changed and the packet is re-routed, the
		source address won't be rewritten to the default source address of the newly chosen route. libpacketmark avoids
		this issue as the packet mark will already be set when the packet is created.

		gluon-wan-dnsmasq
		~~~~~~~~~~~~~~~~~
		To separate the DNS servers in the mesh from the ones on the WAN, the ``gluon-wan-dnsmasq`` package provides
		a secondary DNS daemon which runs on ``127.0.0.1:54``. It will automatically use all DNS servers explicitly
		configured in ``/etc/config/gluon-wan-dnsmasq`` or received via DNS/RA on the WAN port. It is important that
		no DNS servers for the WAN interface are configured in ``/etc/config/network`` and that ``peerdns`` is set to 0
		so the WAN DNS servers aren't leaked to the primary DNS daemon.

		libpacketmark is used to make the secondary DNS daemon send its requests over the WAN interface.

		The package ``gluon-mesh-vpn-fastd`` provides an iptables rule which will redirect all DNS requests from processes running
		with the primary group ``gluon-mesh-vpn`` to ``127.0.0.1:54``, thus making fastd use the secondary DNS daemon.

docs/dev/web/config-mode.rst

0 → 100644

+92 −0

Original line number	Diff line number	Diff line
		Config Mode
		===========

		The `Config Mode` consists of several modules that provide a range of different
		configuration options:

		gluon-config-mode-core
		This modules provides the core functionality for the config mode.
		All modules must depend on it.

		gluon-config-mode-hostname
		Provides a hostname field.

		:doc:`gluon-config-mode-autoupdater <../../features/autoupdater>`
		Informs whether the autoupdater is enabled.

		:doc:`gluon-config-mode-mesh-vpn <../../features/vpn>`
		Allows toggling of installed mesh-vpn technology and setting a bandwidth limit.

		gluon-config-mode-geo-location
		Enables the user to set the geographical location of the node.

		:doc:`../../package/gluon-config-mode-geo-location-osm`
		Lets the user click on a map to select the geographical location through a OSM map

		gluon-config-mode-contact-info
		Adds a field where the user can provide contact information.

		:doc:`../../package/gluon-web-cellular`
		Adds advanced options to enter WWAN config.

		:doc:`../../package/gluon-web-network`
		Adds option to configure used role on interfaces

		Most of the configuration options are described in :ref:`user-site-config_mode`

		Writing Config Mode modules
		~~~~~~~~~~~~~~~~~~~~~~~~~~~

		Config mode modules are located at ``/lib/gluon/config-mode/wizard`` and
		``/lib/gluon/config-mode/reboot``. Modules are named like ``0000-name.lua`` and
		are executed in lexical order. In the standard package set, the
		order is, for wizard modules:

		- 0050-autoupdater-info
		- 0100-hostname
		- 0300-mesh-vpn
		- 0400-geo-location
		- 0500-contact-info

		The reboot module order is:

		- 0100-mesh-vpn
		- 0900-msg-reboot

		All modules are run in the gluon-web model context and have access to the same
		variables as "full" gluon-web modules.

		Wizards
		-------

		Wizard modules must return a function that is provided with the wizard form and an
		UCI cursor. The function can create configuration sections in the form:

		.. code-block:: lua

		return function(form, uci)
		local s = form:section(Section)
		local o = s:option(Value, "hostname", "Hostname")
		o.default = uci:get_first("system", "system", "hostname")
		o.datatype = "hostname"

		function o:write(data)
		uci:set("system", uci:get_first("system", "system"), "hostname", data)
		end

		return {'system'}
		end

		The function may return a table of UCI packages to commit after the individual
		fields' `write` methods have been executed. This is done to avoid committing the
		packages repeatedly when multiple wizard modules modify the same package.

		Reboot page
		-----------

		Reboot modules are simply executed when the reboot page is
		rendered:

		.. code-block:: lua

		renderer.render_string("Hello World!")

docs/dev/web/controller.rst

0 → 100644

+124 −0

Original line number	Diff line number	Diff line
		Controllers
		===========

		Controllers live in the ``controller`` subdirectory of a gluon-web application
		(``/lib/gluon/config-mode/controller`` for the config mode,
		``/lib/gluon/status-page/controller`` for the status page). They define which pages ("routes")
		exist under the application base URL, and what code is run when these pages are requested.

		Controller scripts usually start with a package declaration, followed by calls
		to the entry function, which each define one route:

		.. code-block:: lua

		package 'gluon-web-admin'

		entry({"admin"}, alias("admin", "info"), _("Advanced settings"), 10)
		entry({"admin", "info"}, template("admin/info"), _("Information"), 1)

		package defines the translation namespace for the titles of the defined
		pages as well as the referenced views and models. The entry function expects 4
		arguments:

		- `path`: Components of the path to define a route for.

		The above example defines routes for the paths ``admin`` and ``admin/info``.

		- `target`: Dispatcher for the route. See the following section for details.
		- `title`: Page title (also used in navigation). The underscore function is used
		to mark the strings as translatable for ``i18n-scan.pl``.

		- `order`: Sort index in navigation (defaults to 100)

		Navigation indexes are automatically generated for each path level. Pages can be
		hidden from the navigation by setting the `hidden` property of the node object
		returned by `entry`:

		.. code-block:: lua

		entry({"hidden"}, alias("foo"), _("I'm hidden!")).hidden = true


		Dispatchers
		-----------

		- alias (path, ...): Redirects to a different page. The path components are
		passed as individual arguments.
		- call (func, ...): Runs a Lua function for custom request handling. The given
		function is called with the HTTP object and the template renderer as first
		two arguments, followed by all additional arguments passed to `call`.
		- template (view): Renders the given view. See :doc:`view`.
		- model (name): Displays and evaluates a form as defined by the given model. See the
		:doc:`model` page for an explanation of gluon-web models.


		.. _web-controller-http:

		The HTTP object
		---------------

		The HTTP object provides information about the HTTP requests and allows to add
		data to the reply. Using it directly is rarely necessary when gluon-web
		models and views are used.

		Useful functions:

		- getenv (key): Returns a value from the CGI environment passed by the webserver.
		- formvalue (key): Returns a value passed in a query string or in the content
		of a POST request. If multiple values with the same name have been passed, only
		the first is returned.
		- formvaluetable (key): Similar to formvalue, but returns a table of all
		values for the given key.
		- status (code, message): Writes the HTTP status to the reply. Has no effect
		if a status has already been sent or non-header data has been written.
		- header (key, value): Adds an HTTP header to the reply to be sent to
		the client. Has no effect when non-header data has already been written.
		- prepare_content (mime): Sets the Content-Type header to the given MIME
		type
		- write (data, ...): Sends the given data to the client. If headers have not
		been sent, it will be done before the data is written.


		HTTP functions are called in method syntax, for example:

		.. code-block:: lua

		http:write('Output!')


		.. _web-controller-template-renderer:

		The template renderer
		---------------------

		The template renderer allows to render templates (views). The most useful functions
		are:

		- render (view, scope, pkg): Renders the given view, optionally passing a table
		with additional variables to make available in the template. The passed package
		defines the translation namespace.
		- render_string (str, scope, pkg): Same as render, but the template is passed
		directly instead of being loaded from the view directory.

		The renderer functions are called in property syntax, for example:

		.. code-block:: lua

		renderer.render('layout')


		Differences from LuCI
		---------------------

		- Controllers must not use the module function to define a Lua module (gluon-web
		will set up a proper environment for each controller itself)
		- Entries are defined at top level, not inside an index function
		- The alias dispatcher triggers an HTTP redirect instead of directly running
		the dispatcher of the aliased route.
		- The call dispatcher is passed a function instead of a string with a function
		name.
		- The cbi dispatcher of LuCI has been renamed to model.
		- The HTTP POST handler support the multipart/form-data encoding only, so
		``enctype="multipart/form-data"`` must be included in all <form> HTML
		elements.
		- Other dispatchers like form are not provided.

docs/dev/web/i18n.rst

0 → 100644

+109 −0

Original line number	Diff line number	Diff line
		Internationalization support
		============================

		General guidelines
		------------------

		* All config mode packages must be fully translatable, with complete English and German texts.
		* All new expert mode packages must be fully translatable. English texts are required.
		* German translations are recommended. Other supported languages, especially French, are
		nice-to-have, but not required. If you don't know a language well, rather leave the translation
		blank, so it is obvious that there is no proper translation yet.
		* Existing expert mode packages should be made translatable as soon as possible.
		* The "message IDs" (which are the arguments to the translate function) should be the
		English texts.

		i18n support in Gluon
		---------------------

		Internationalization support is available in all components (models, view and
		controllers) of gluon-web-based packages. Strings are translated using the translate,
		_translate and translatef functions (translate for static strings, translatef
		for printf-like formatted string; _translate works the same as translate, but
		will return nil instead of the original string when no translation is available).

		In views, the special tags ``<%:...%>`` can be used to translate the contained string.

		Example from the gluon-config-mode-geo-location package:

		.. code-block:: lua

		local share_location = s:option(Flag, "location", translate("Show node on the map"))

		Note that translations are namespaced: each package will only use its own
		translation strings by default. For this purpose, the package name must by
		specified in a package's controller. It is possible to access a different
		translation package using the i18n function from models and view, which is
		necessary when strings from the site configuration are used, or packages do not
		have their own controller (which is the case for config mode wizard components).

		.. code-block:: lua

		local site_i18n = i18n 'gluon-site'
		local msg = site_i18n._translate('gluon-config-mode:welcome')

		Adding translation templates to Gluon packages
		----------------------------------------------

		The i18n support is based on the standard gettext system. For each translatable package,
		a translation template with extension ``.pot`` can be created using the i18n-scan.pl
		script in the ``contrib`` directory:

		.. code-block:: sh

		cd package/gluon-web-mesh-vpn-fastd
		mkdir i18n
		cd i18n
		../../../contrib/i18n-scan.pl ../files ../luasrc > gluon-web-mesh-vpn-fastd.pot

		The same command can be run again to update the template.

		In addition, the Makefile must be adjusted. Instead of OpenWrt's default package.mk,
		the Gluon version (``../gluon.mk`` for core packages) must be used. The i18n files must be installed
		and PKG_CONFIG_DEPENDS must be added::

		...
		include ../gluon.mk

		PKG_CONFIG_DEPENDS += $(GLUON_I18N_CONFIG)
		...
		define Build/Compile
		$(call GluonBuildI18N,gluon-web-mesh-vpn-fastd,i18n)
		endef

		define Package/gluon-web-mesh-vpn-fastd/install
		...
		$(call GluonInstallI18N,gluon-web-mesh-vpn-fastd,$(1))
		endef
		...


		Adding translations
		-------------------

		A new translation file for a template can be added using the msginit command:

		.. code-block:: sh

		cd package/gluon-web-mesh-vpn-fastd/i18n
		msginit -l de

		This will create the file de.po in which the translations can be added.

		The translation file can be updated to a new template version using the msgmerge command:

		.. code-block:: sh

		msgmerge -U de.po gluon-web-mesh-vpn-fastd.pot

		After the merge, the translation file should be checked for "fuzzy matched" entries where
		the original English texts have changed. All entries from the translation file should be
		translated in the .po file (or removed from it, so the original English texts are displayed
		instead).

		Adding support for new languages
		--------------------------------

		A list of all languages supported by gluon-web can be found in ``package/gluon.mk``.
		New languages just need to be added to GLUON_SUPPORTED_LANGS, and a human-readable
		language name must be defined.

docs/dev/web/model.rst

0 → 100644

+153 −0

Original line number	Diff line number	Diff line
		Models
		======

		Models are defined in the ``model`` subdirectory of a gluon-web application
		(``/lib/gluon/config-mode/model`` for the config mode; the status
		page does not use any models). Model support is not part of the gluon-web core
		anymore, but is provided by the gluon-web-model package.

		Each model defines one or more forms to display on a page, and how the submitted
		form data is handled.

		Let's start with an example:

		.. code-block:: lua

		local f = Form(translate('Hostname'))

		local s = f:section(Section)

		local o = s:option(Value, 'hostname', translate('Hostname'))
		o.default = uci:get_first('system', 'system', 'hostname')
		function o:write(data)
		uci:set('system', uci:get_first('system', 'system'), 'hostname', data)
		uci:commit('system')
		end

		return f

		The top-level element of a model is always a Form, but it is also possible for
		a model to return multiple forms, which are displayed one below the other.

		A Form has one or more Sections, and each Section has different types
		of options.

		All of these elements have an id, which is used to identify them in the HTML
		form and handlers. If no ID is given, numerical IDs will be assigned automatically,
		but using explicitly named elements is often advisable (and it is required if a
		form does not always include the same elements, i.e., some forms, sections or
		options are added conditionally). IDs are hierarchical, so in the above example,
		the Value would get the ID ``1.1.hostname`` (value hostname in first section
		of first form).

		Classes and methods
		-------------------

		- Form (title, description, id)

		- Form:section (type, title, description, id)

		Creates a new section of the given type (usually Section).

		- Form:write ()

		Is called after the form has been submitted (but only if the data is valid). It
		is called last (after all options' write methods) and is usually used
		to commit changed UCI packages.

		The default implementation of write doesn't do anything, but it can be
		overridden.

		- Section (usually instantiated through Form:section)

		- Section:option (type, id, title, description)

		Creates a new option of the given type. Option types:

		- Value: simple text entry
		- TextValue: multiline text field
		- ListValue: radio buttons or dropdown selection
		- DynamicList: variable number of text entry fields
		- Flag: checkbox

		Most option types share the same properties and methods:

		- default: default value
		- optional: value may be empty
		- datatype: one of the types described in :ref:`web-model-datatypes`

		By default (when datatype is nil), all values are accepted.

		- state: has one of the values FORM_NODATA, FORM_VALID and FORM_INVALID
		when read in a form handler

		An option that has not been submitted because of its dependencies will have
		the state FORM_NODATA, FORM_INVALID if the submitted value is not valid
		according to the set datatype, and FORM_VALID otherwise.

		- data: can be read in form handlers to get the submitted value

		- depends (self, option, value): adds a dependency on another option

		The option will only be shown when the passed option has the given value. This
		is mainly useful when the other value is a Flag or ListValue.

		- depends (self, deps): adds a dependency on multiple other options

		deps must be a table with options as keys and values as values. The option
		will only be shown when all passed options have the corresponding values.

		Multiple alternative dependencies can be added by calling depends repeatedly.

		- value (self, value, text): adds a choice to a ListValue

		- write (self, data): is called with the submitted value when all form data is valid.

		Does not do anything by default, but can be overridden.

		The default value, the value argument to depends and the output data always have
		the same type, which is usually a string (or nil for optional values). Exceptions
		are:

		- Flag uses boolean values
		- DynamicList uses a table of strings

		Despite its name, the datatype setting does not affect the returned value type,
		but only defines a validator the check the submitted value with.

		For a more complete example that actually makes use of most of these features,
		have a look at the model of the gluon-web-network package.

		.. _web-model-datatypes:

		Data types
		----------

		- integer: an integral number
		- uinteger: an integral number greater than or equal to zero
		- float: a number
		- ufloat: a number greater than or equal to zero
		- ipaddr: an IPv4 or IPv6 address
		- ip4addr: an IPv4 address
		- ip6addr: an IPv6 address
		- wpakey: a string usable as a WPA key (either between 8 and 63 characters, or 64 hex digits)
		- range (min, max): a number in the given range (inclusive)
		- min (min): a number greater than or equal to the given minimum
		- max (max): a number less than or equal to the given maximum
		- irange (min, max): an integral number in the given range (inclusive)
		- imin (min): an integral number greater than or equal to the given minimum
		- imax (max): an integral number less than or equal to the given maximum
		- minlength (min): a string with the given minimum length
		- maxlength (max): a string with the given maximum length

		Differences from LuCI
		---------------------

		- LuCI's SimpleForm and SimpleSection are called Form and Section, respectively
		- Is it not possible to add options to a Form directly, a Section must always
		be created explicitly
		- Many of LuCI's CBI classes have been removed, most importantly the Map
		- The rmempty option attribute does not exist, use optional instead
		- Only the described data types are supported
		- Form handlers work completely differently (in particular, a Form's handle
		method should usually not be overridden in gluon-web)

docs/dev/web/view.rst

0 → 100644

+60 −0

Original line number	Diff line number	Diff line
		Views
		=====

		The template parser reads views from the ``view`` subdirectory of a
		gluon-web application (``/lib/gluon/config-mode/view`` for the config mode,
		``lib/gluon/status-page/view`` for the status page).
		Writing own views should usually be avoided in favour of using :doc:`model`
		with their predefined views.

		Views are partial HTML pages, with additional template tags that allow
		to embed Lua code and translation strings. The following tags are defined:

		- ``<%`` ... ``%>`` evaluates the enclosed Lua expression.
		- ``<%\|`` ... ``%>`` evaluates the enclosed Lua expression and prints its value.
		- ``<%=`` ... ``%>`` evaluates the enclosed Lua expression and prints its value
		without escaping HTML entities. This is useful when the value contains HTML code.
		- ``<%+`` ... ``%>`` includes another template.
		- ``<%:`` ... ``%>`` translates the enclosed string using the loaded i18n catalog.
		- ``<%_`` ... ``%>`` translates the enclosed string without escaping HTML entities
		in the translation. This only makes sense when the i18n catalog contains HTML code.
		- ``<%#`` ... ``%>`` is a comment.

		All of these also come in the whitespace-stripping variants ``<%-`` and ``-%>`` that
		remove all whitespace before or after the tag.

		Complex combinations of HTML and Lua code are possible, for example:

		.. code-block:: text

		<div>
		<% if foo then %>
		Content
		<% end %>
		</div>


		Variables and functions
		-----------------------

		Many call sites define additional variables (for example, model templates can
		access the model as self and a unique element ID as id), but the following
		variables and functions should always be available for the embedded Lua code:

		- renderer: :ref:`web-controller-template-renderer`
		- http: :ref:`web-controller-http`
		- request: Table containing the path components of the current page
		- url (path): returns the URL for the given path, which is passed as a table of path components.
		- attr (key, value): Returns a string of the form ``key="value"``
		(with a leading space character before the key).

		value is converted to a string (tables are serialized as JSON) and HTML entities
		are escaped. Returns an empty string when value is nil or false.
		- include (template): Includes another template.
		- node (path, ...): Returns the controller node for the given page (passed as
		one argument per path component).

		Use ``node(unpack(request))`` to get the node for the current page.
		- pcdata (str): Escapes HTML entities in the passed string.
		- urlencode (str): Escapes the passed string for use in an URL.
		- translate, _translate, translatef and i18n: see :doc:`i18n`

docs/features/authorized-keys.rst

0 → 100644

+15 −0

Original line number	Diff line number	Diff line
		Adding SSH public keys
		======================

		By using the package ``gluon-authorized-keys`` it is possible to add
		SSH public keys to an image to permit root login.

		If you select this package, add a list of authorized keys to ``site.conf`` like this:::

		{
		authorized_keys = { 'ssh-rsa AAA.... user1@host',
		'ssh-rsa AAA.... user2@host' },
		hostname_prefix = ...
		...

		Existing keys in ``/etc/dropbear/authorized_keys`` will be preserved.

docs/features/autoupdater.rst

0 → 100644

+140 −0

Original line number	Diff line number	Diff line
		Autoupdater
		===========

		Gluon contains an automatic update system which can be configured in the site configuration.

		Building Images
		---------------

		By default, the autoupdater is disabled (as it is usually not helpful to have unexpected updates
		during development), but it can be enabled by setting the variable ``GLUON_AUTOUPDATER_ENABLED`` to ``1`` when building.
		It is also possible to override the default branch during build using the variable ``GLUON_AUTOUPDATER_BRANCH``.

		If a default branch is set neither in site.conf nor via ``GLUON_AUTOUPDATER_BRANCH``, the default branch is
		implementation-defined. Currently, the branch with the first name in alphabetical order is chosen.

		A manifest file for the updater can be generated with `make manifest`. A signing script (using
		``ecdsautils``) can be found in the `contrib` directory. When creating the manifest, the
		``PRIORITY`` value may be defined by setting ``GLUON_PRIORITY`` on the command line or in ``site.mk``.

		``GLUON_PRIORITY`` defines the maximum number of days that may pass between releasing an update and installation
		of the images. The update probability will start at 0 after the release time declared in the manifest file
		by the variable DATE and then slowly rise up to 1 when ``GLUON_PRIORITY`` days have passed. The autoupdater checks
		for updates hourly (at a random minute of the hour), but usually only updates during its run between
		4am and 5am, except when the whole ``GLUON_PRIORITY`` days and another 24 hours have passed.

		``GLUON_PRIORITY`` may be an integer or a decimal fraction.

		If ``GLUON_RELEASE`` is passed to ``make`` explicitly or it is generated dynamically
		in ``site.mk``, care must be taken to pass the same ``GLUON_RELEASE`` to ``make manifest``,
		as otherwise the generated manifest will be incomplete.


		Manifest format
		---------------

		The manifest starts with a short header, followed by the list of firmwares and signatures.
		The header contains the following information:

		.. code-block:: sh

		BRANCH=stable
		DATE=2020-10-07 00:00:00+02:00
		PRIORITY=7

		- ``BRANCH`` is the autoupdater branch name that needs to match the nodes configuration.
		- ``DATE`` specifies when the time period for the update begins. Nodes will do their regular update during a random minute
		between 4:00 and 4:59 am. Nodes might not always have a reliable NTP synchronization, which is why a fallback mechanism
		exists, that checks for an update, and will execute if ``DATE`` is at least 24h in the past.
		- ``PRIORITY`` can be configured as ``GLUON_PRIORITY`` when generating the manifest or in ``site.mk``, and defines
		the number of days over which the update should be stretched out after ``DATE``. Nodes will calculate a probability
		based on the time left to determine when to update.

		Signing images
		--------------

		As noted above, manifest files can be signed by an arbitrary amount of ECDSA keys.
		The amount of valid signatures required to have the autoupdater accept an image is configured using the :ref:`site.conf <user-site-autoupdater>`.

		A secret key (that like an SSH private key must never be shared) can be generated like this:

		.. code-block:: sh

		mkdir ~/.ecdsa/
		( umask 077 && ecdsautil generate-key > ~/.ecdsa/id_y25519 )

		This is then used to derive a public key, meant to be placed in the ``site.conf``.

		.. code-block:: sh

		( umask 033 && ecdsautil show-key < ~/.ecdsa/id_y25519 > ~/.ecdsa/id_y25519.pub )

		A manifest can then be signed using the helper in gluons `contrib` directory.

		.. code-block:: sh

		./contrib/sign.sh ~/.ecdsa/id_y25519 output/images/sysupgrade/stable.manifest

		In the manifest file only the content above the three dashes is signed, not other signatures that might exist.

		Automated nightly builds
		------------------------

		A fully automated nightly build could use the following commands:

		.. code-block:: sh

		git pull
		# git -C site pull
		make update
		make clean GLUON_TARGET=ath79-generic
		NUM_CORES_PLUS_ONE=$(expr $(nproc) + 1)
		make -j$NUM_CORES_PLUS_ONE GLUON_TARGET=ath79-generic GLUON_RELEASE=$GLUON_RELEASE \
		GLUON_AUTOUPDATER_BRANCH=experimental GLUON_AUTOUPDATER_ENABLED=1
		make manifest GLUON_RELEASE=$GLUON_RELEASE GLUON_AUTOUPDATER_BRANCH=experimental
		contrib/sign.sh $SECRETKEY output/images/sysupgrade/experimental.manifest

		rm -rf /where/to/put/this/experimental
		cp -r output/images /where/to/put/this/experimental


		Infrastructure
		--------------

		We suggest to have following directory tree accessible via http:

		::

		firmware/
		stable/
		sysupgrade/
		factory/
		snapshot/
		sysupgrade/
		factory/
		experimental/
		sysupgrade/
		factory/

		The server must be available via IPv6.

		Command Line
		------------

		These commands can be used on a node:

		::

		# Update with some probability
		autoupdater

		::

		# Force update check, even when the updater is disabled
		autoupdater -f

		::

		# If fallback is true the updater will perform an update only if the timespan
		# PRIORITY days (as defined in the manifest) and another 24h have passed
		autoupdater --fallback

docs/features/configmode.png

0 → 100644

+112 KiB

111.76 KiB

docs/features/configmode.rst

0 → 100644

+54 −0

Original line number	Diff line number	Diff line
		Config Mode
		===========

		When in Config Mode a node will neither participate in the mesh nor connect
		to the VPN using the WAN port. Instead, it'll offer a web interface on the
		LAN port to aid configuration of the node.

		Whether a node is in Config Mode can be determined by a characteristic
		blinking sequence of the SYS LED:

		.. image:: node_configmode.gif

		Activating Config Mode
		----------------------

		Config Mode is automatically entered at the first boot. You can re-enter
		Config Mode by pressing and holding the RESET/WPS/DECT button for about three
		seconds. The device should reboot (all LEDs will turn off briefly) and
		Config Mode will be available.

		If you have access to the console of the node, there is the
		``gluon-enter-setup-mode`` command, which reboots a node into Config Mode.


		Port Configuration
		------------------

		In general, Config Mode will be offered on the LAN ports. However, there
		are two practical exceptions:

		* Devices with just one network port will run Config Mode on that port.
		* Devices with PoE on the WAN port will run Config Mode on the WAN port instead.


		Accessing Config Mode
		---------------------

		Config Mode can be accessed at http://192.168.1.1. The node will offer DHCP
		to clients. Should this fail, you may assign an IP from 192.168.1.0/24 to
		your computer manually.

		.. image:: configmode.png

		Advanced Config Options
		-----------------------

		Depending on the installed packages, the advanced config mode allows to configure packages further.

		* :doc:`gluon-web-wifi-config enable <wlan-configuration>` radios used for wifi and mesh as well as outdoor mode
		* :doc:`../package/gluon-web-network` allows to configure the used roles (uplink, mesh, client) on each interface
		* :doc:`../package/gluon-web-admin` allows to enter SSH keys or set a password in the `Remote access` section
		* :doc:`../package/gluon-web-cellular` allows to configure SIM card / WWAN settings on supported cellular devices

		The advanced config does also allow to upload a sysupgrade file to update the firmware to a different version.

docs/features/dns-cache.rst

0 → 100644

+53 −0

Original line number	Diff line number	Diff line
		.. _dns-caching:

		DNS caching
		===========

		User experience may be greatly improved when dns is accelerated. Also, it
		seems like a good idea to keep the number of packages being exchanged
		between node and gateway as small as possible. In order to do this, a
		DNS cache may be used on a node. The dnsmasq instance listening on port
		53 on the node will be reconfigured to answer requests, use a list of
		upstream servers and a specific cache size if the options listed below are
		added to site.conf. Upstream servers are the DNS servers which are normally
		used by the nodes to resolve hostnames (e.g. gateways/supernodes).

		There are the following settings:
		servers
		cacheentries

		To use the node's DNS server, both options should be set. The node will cache at
		most 'cacheentries' many DNS records in RAM. The 'servers' list will be used to
		resolve the received DNS queries if the request cannot be answered from
		cache. Gateways should announce the "next node" address via DHCP and RDNSS (if
		any). Note that not setting 'servers' here will lead to DNS not working: Once
		the gateways all announce the "next node" address for DNS, there is no way for
		nodes to automatically determine DNS servers. They have to be baked into the
		firmware.

		If these settings do not exist, the cache is not initialized and RAM usage will
		not increase.

		When next_node.name is set, an A record and an AAAA record for the
		next-node IP address are placed in the dnsmasq configuration. This means that
		the content of next_node.name may be resolved even without upstream connectivity.
		It is suggested to use the same name as the DNS server provides:
		e.g. nextnode.location.community.example.org (This way the name also works if a
		client uses static DNS Servers). Hint: If next_node.name does not contain a dot
		some browsers would open the searchpage instead.

		::

		dns = {
		cacheentries = 5000,
		servers = { '2001:4860:4860::8888', '2001:4860:4860::8844' },
		},

		next_node = {
		name = { 'nextnode.location.community.example.org', 'nextnode', 'nn' },
		ip6 = '2001:db8:8::1',
		ip4 = '198.51.100.1',
		}


		Each cache entry will occupy about 90 bytes of RAM.

docs/features/fastd_mode.gif

0 → 100644

+28.1 KiB

28.12 KiB

docs/features/monitoring.rst

0 → 100644

+139 −0

Original line number	Diff line number	Diff line
		Node monitoring
		===============

		Gluon is capable of announcing information about each node to the mesh
		and to neighbouring nodes. This allows nodes to learn each others hostname,
		IP addresses, location, software versions and various other information.

		Format of collected data
		------------------------

		Information to be announced is currently split into three categories:

		nodeinfo
		In this category (mostly) static information is collected. If
		something is unlikely to change without human intervention it should be
		put here.

		statistics
		This category holds fast changing data, like traffic counters, uptime,
		system load or the selected gateway.

		neighbours
		`neighbours` contains information about all neighbouring nodes of all
		interfaces. This data can be used to determine the network topology.

		All categories will have a ``node_id`` key. It should be used to
		relate data of different categories.

		Accessing Node Information
		--------------------------

		There are two packages responsible for distribution of the information. For
		one, information is distributed across the mesh using alfred_. Information
		between neighbouring nodes is exchanged using `gluon-respondd`.

		.. _alfred: https://www.open-mesh.org/projects/alfred

		alfred (mesh bound)
		~~~~~~~~~~~~~~~~~~~

		The package ``gluon-alfred`` is required for this to work.

		Using alfred both categories are distributed within the mesh. In order to
		retrieve the data you'll need both a local alfred daemon and alfred-json_
		installed. Please note that at least one alfred daemon is required to run as
		`master`.

		.. _alfred-json: https://github.com/ffnord/alfred-json

		The following data types are used:

		* `nodeinfo`: 158
		* `statistics`: 159
		* `neighbours`: 160

		All data is compressed using GZip (alfred-json can handle the decompression).

		In order to retrieve statistics data you could run:

		::

		# alfred-json -z -r 159
		{
		"f8:d1:11:7e:97:dc": {
		"processes": {
		"total": 55,
		"running": 2
		},
		"idletime": 30632.290000000001,
		"uptime": 33200.07,
		"memory": {
		"free": 1660,
		"cached": 8268,
		"total": 29212,
		"buffers": 2236
		},
		"node_id": "f8d1117e97dc",
		"loadavg": 0.01
		},
		"90:f6:52:3e:b9:50": {
		"processes": {
		"total": 58,
		"running": 2
		},
		"idletime": 28047.470000000001,
		"uptime": 33307.849999999999,
		"memory": {
		"free": 2364,
		"cached": 7168,
		"total": 29212,
		"buffers": 1952
		},
		"node_id": "90f6523eb950",
		"loadavg": 0.34000000000000002
		}
		}

		You can find more information about alfred in its README_.

		.. _README: https://git.open-mesh.org/alfred.git/blob_plain/refs/heads/master:/README.rst

		gluon-respondd
		~~~~~~~~~~~~~~

		`gluon-respondd` allows querying neighbouring nodes for their information.
		It is a daemon listening on the multicast address ``ff02::2:1001`` on
		UDP port 1001 on the mesh interface and on the multicast address
		``ff05::2:1001`` on the `br-client` interface. Unicast
		requests are supported as well.

		The supported requests are:

		* ``nodeinfo``, ``statistics``, ``neighbours``: Returns the data of single category uncompressed.
		* ``GET nodeinfo``, ...: Returns the data of one or multiple categories (separated by spaces)
		compressed using the `deflate` algorithm (without a gzip header). The data may
		be decompressed using zlib and many zlib bindings using -15 as the window size parameter.

		gluon-neighbour-info
		~~~~~~~~~~~~~~~~~~~~

		The program `gluon-neighbour-info` can be used to retrieve
		information from other nodes.

		::

		gluon-neighbour-info -i bat0 \
		-p 1001 -d ff05:0:0:0:0:0:2:1001 \
		-r nodeinfo

		An optional timeout may be specified, e.g. `-t 5` (default: 3 seconds). See
		the usage information printed by ``gluon-neighbour-info -h`` for more information
		about the supported arguments.

		Adding a data provider
		----------------------

		To add a provider, you need to install a shared object into ``/lib/gluon/respondd``.
		For more information, refer to the `respondd README <https://github.com/freifunk-gluon/packages/blob/main/net/respondd/README.md>`_
		and have a look the existing providers.

docs/features/multidomain.rst

0 → 100644

+272 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/features/multidomain_configmode.gif

0 → 100644

+57.1 KiB

57.14 KiB

docs/features/node_configmode.gif

0 → 100644

+50.5 KiB

50.45 KiB

docs/features/private-wlan.rst

0 → 100644

+41 −0

Original line number	Diff line number	Diff line
		Private WLAN
		============

		It is possible to set up a private WLAN that bridges the uplink port and is separated from the mesh network.
		Please note that you should not enable Wired Mesh on the uplink port at the same time.

		The private WLAN is encrypted using WPA2 by default. On devices with enough flash and a supported radio,
		WPA3 or WPA2/WPA3 mixed-mode can be used instead of WPA2. For this to work, the ``wireless-encryption-wpa3``
		feature has to be enabled as a feature.

		It is recommended to enable IEEE 802.11w management frame protection for WPA2/WPA3 networks, however this
		can lead to connectivity problems for older clients. In this case, management frame protection can be
		made optional or completely disabled in the advanced settings tab.

		The private WLAN can be enabled through the config mode if the package ``gluon-web-private-wifi`` is installed.
		You may also enable a private WLAN using the command line::

		RID=0
		SSID="privateWLANname"
		KEY="yoursecret1337password"

		uci set wireless.wan_radio$RID=wifi-iface
		uci set wireless.wan_radio$RID.device=radio$RID
		uci set wireless.wan_radio$RID.network=wan
		uci set wireless.wan_radio$RID.mode=ap
		uci set wireless.wan_radio$RID.encryption=psk2
		uci set wireless.wan_radio$RID.ssid="$SSID"
		uci set wireless.wan_radio$RID.key="$KEY"
		uci set wireless.wan_radio$RID.disabled=0
		uci set wireless.wan_radio$RID.macaddr=$(lua -e "print(require('gluon.wireless').get_wlan_mac('wan_radio', $RID))")
		uci commit
		wifi

		Please replace ``$SSID`` by the name of the WLAN and ``$KEY`` by your passphrase (8-63 characters).
		If you have two radios (e.g. 2.4 and 5 GHz) you need to do this for radio0 and radio1.

		It may also be disabled by running::

		uci set wireless.wan_radio0.disabled=1
		uci commit
		wifi

docs/features/roles.rst

0 → 100644

+34 −0

Original line number	Diff line number	Diff line
		Roles
		=====

		It is possible to define a set of roles you want to distinguish at backend side. One node can own one
		role which it will announce via respondd/announced inside the mesh. This will make it easier to differentiate
		nodes when parsing respondd data. E.g to count only normal nodes and not the gateways
		or servers (nodemap). A lot of things are possible.

		For this the section ``roles`` in ``site.conf`` is needed::

		roles = {
		default = 'node',
		list = {
		'node',
		'test',
		'backbone',
		'service',
		},
		},

		The strings to display in the web interface are configured per language in the
		``i18n/en.po``, ``i18n/de.po``, etc. files of the site repository using message IDs like
		``gluon-web-node-role:role:node`` and ``gluon-web-node-role:role:backbone``.

		The value of ``default`` is the role every node will initially own. This value should be part of ``list`` as well.
		If you want node owners to change the defined roles via config-mode you can add the package
		``gluon-web-node-role`` to your ``site.mk``.

		The role is saved in ``gluon-node-info.system.role``. To change the role using command line do::

		uci set gluon-node-info.@system[0].role="$ROLE"
		uci commit

		Please replace ``$ROLE`` by the role you want the node to own.

docs/features/status-page.png

0 → 100644

+150 KiB

149.70 KiB

docs/features/status-page.rst

0 → 100644

+30 −0

Original line number	Diff line number	Diff line
		Status-Page
		===========

		When the feature ``gluon-status-page`` is enabled, Gluon nodes run a HTTP server with status information on all IP addresses of ``br-client``.
		This makes it possible to check information of the node in realtime.

		If the mesh protocol ``gluon-mesh-batman-adv`` is installed too, the package ``gluon-status-page-mesh-batman-adv`` is added too according to the :ref:`user-site-feature-flags`

		.. _status-page-example-picture:

		Example Picture
		---------------

		The left side of the status page contains Overview information.
		In the middle, current monitoring information abut the system, number of clients, radios, amount of traffic and connected mesh-vpn if any are shown.
		The right side of the Status-Page contains information about Neighbours to this node through :doc:`wired-mesh` as well as wireless mesh.

		.. image:: status-page.png

		Mesh Graphs
		-----------

		When wireless mesh is enabled, the mesh interfaces show realtime Graphs about the received signal strength (RSSI) in dBm.

		Neighbours
		----------

		The list of neighbours at first shows the mac-address of the neighbour it sees.
		The status-page sends a second request to ``http://[ipv6]/cgi-bin/dyn/neighbours-nodeinfo?mesh-vpn`` which triggers the lookup of neighbour information on the node itself.
		Through this, the actual nodenames of the neighbours are shown on the status-page as can be seen in the :ref:`status-page-example-picture`.

docs/features/tls.rst

0 → 100644

+10 −0

Original line number	Diff line number	Diff line
		TLS support
		===========

		The generic TLS implementation which is currently used by OpenWRT can be installed or added as dependency through the package ``gluon-tls``.
		This removes the need for community packages to depend on a specific TLS implementation (like mbedtls, OpenSSL or WolfSSL).

		This package is an alias for the current TLS implementation used.
		To allow for easy usage of communicating through HTTPS from the node, typical Certificate Authorities (CAs) are included through the package ``ca-bundle`` .

		* Starting with OpenWRT 23.05, mbedtls is the default TLS layer - this is reflected in Gluon :ref:`v2023.2 <releases-v2023.2-minor-changes>`. HTTPS is used by default to communicate with OpenWRT opkg servers.

docs/features/vpn.rst

0 → 100644

+250 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/features/wired-mesh.rst

0 → 100644

+133 −0

Original line number	Diff line number	Diff line
		Wired mesh (Mesh-on-WAN/LAN)
		############################

		In addition to meshing over WLAN and VPN, it is also possible to
		configure wired meshing over the LAN or WAN ports. This allows
		nodes to be connected directly or over wireless bridges.

		Mesh-on-WAN can be enabled in addition to the mesh VPN, so multiple nodes
		in the same local network that is used as VPN uplink can also mesh directly.
		Enabling Mesh-on-WAN should be avoided if the local network is also bridged with
		a WLAN access point, as meshing over batman-adv causes large amounts of
		multicast traffic, which will take up a lot of airtime.

		Enabling Mesh-on-LAN replaces the normal "client network" function
		of the LAN ports, as client network ports may never be connected (so care must be taken to always
		enable Mesh-on-LAN before connecting two nodes' LAN ports).

		Wired mesh encapsulation
		************************

		Since version 2018.1, Gluon supports encapsulating wired mesh traffic in
		`VXLAN <https://en.wikipedia.org/wiki/Virtual_Extensible_LAN>`_, a new standard with
		use cases similar to VLANs, but a much greater ID space of 24bit; in addition, VXLAN
		packets pass through VLAN-aware switches without any special configuration.

		Encapsulating mesh traffic has two advantages:

		* By using a different VXLAN ID for each site and mesh domain, accidental
		wired mesh connections between nodes of different domains will be prevented.
		This has special importance when nodes migrate between domains automatically,
		as currently possible through different site-specific packages.
		* While batman-adv traffic does not interact with non-mesh traffic in the same wired
		network in any way (so Gluon nodes can mesh over existing wired networks), this is
		not the case for layer 3 mesh protocols like Babel. Encapsulating the traffic allows
		to distinguish mesh traffic from unrelated packets.

		As enabling VXLAN encapsulation will prevent wired mesh communication with old nodes
		that do not support VXLAN yet, VXLANs can be enabled per-domain using the site configuration
		setting mesh.vxlan. VXLAN is enabled by default in multidomain setups; in single-domain
		site configurations, the mesh.vxlan setting is mandatory. We recommend to enable
		VXLAN encapsulation in all new sites and domains.

		Non-encapsulated ("legacy") wired meshing will be removed in a future Gluon release.
		We cannot give a concrete timeframe for the removal yet; a missing prerequisite is the
		implementation of a robust migration path for existing deployments.

		Configuration
		*************

		Both Mesh-on-WAN and Mesh-on-LAN can be configured on the "Network" page
		of the Advanced settings (if the package ``gluon-web-network`` is installed).

		It is also possible to enable Mesh-on-WAN and Mesh-on-LAN by default by adding
		the ``mesh`` role to the ``interfaces.*.default_roles`` options in your
		:ref:`site.conf<user-site-interfaces>`.


		.. _wired-mesh-commandline:

		Commandline
		===========

		Starting with release 2022.1, the wired network configuration is rebuilt from ``/etc/config/gluon``
		upon each ``gluon-reconfigure``.
		Therefore the network configuration is overwritten at least with every firmware upgrade.

		Every interface has a list of roles assigned to it which can be ``client``, ``mesh`` or ``uplink``.

		When the client role is assigned to an interface in combination with other roles
		(like 'client', 'mesh' in the Mesh-on-LAN example below), the other roles take
		precedence, enabling mesh but not client in the previous example.

		The setup/config-mode interface is every interface with the role ``client`` which makes removing
		it from interfaces not only unnecessary, but generally unrecommended.

		In order to make persistent changes to the router's configuration it's necessary to:

		* change the sections in ``/etc/config/gluon`` e.g. using uci (see examples below)
		* call ``gluon-reconfigure`` to re-generate ``/etc/config/network``
		* apply the networking changes, either through executing ``service network restart`` or by performing a ``reboot``

		Enable Mesh-on-WAN::

		uci add_list gluon.iface_wan.role='mesh'
		uci commit gluon

		Disable Mesh-on-WAN::

		uci del_list gluon.iface_wan.role='mesh'
		uci commit gluon

		Enable Mesh-on-LAN::

		uci add_list gluon.iface_lan.role='mesh'
		uci commit gluon

		Disable Mesh-on-LAN::

		uci del_list gluon.iface_lan.role='mesh'
		uci commit gluon

		For devices with a single interface, instead of `iface_lan` and `iface_wan` configuration is
		done with `iface_single`.

		Enable Mesh-on-Single::

		uci add_list gluon.iface_single.role='mesh'
		uci commit gluon

		Disable Mesh-on-Single::

		uci del_list gluon.iface_single.role='mesh'
		uci commit gluon

		Furthermore it is possible to make use of 802.1Q VLAN.
		The following statements would create a VLAN with id 8 on ``eth0`` and join the mesh network with it::

		uci set gluon.iface_lan_vlan8=interface
		uci set gluon.iface_lan_vlan8.name='eth0.8'
		uci add_list gluon.iface_lan_vlan8.role='mesh'
		uci commit gluon

		Other VLAN-interfaces could be configured on the same parent interface in order to have
		all three roles available on ``eth0`` without having them interfere with each other.
		This feature comes in especially handy for the persistent configuration of virtual machines
		as offloader for bigger installations.

		A ``reboot`` is not sufficient to apply an altered configuration; calling ``gluon-reconfigure`` before is
		mandatory in order for changes to take effect.

		Please note that this configuration has changed in Gluon 2022.1. Using
		the old commands on 2022.1 and later will break the corresponding options
		in the Advanced settings.

docs/features/wlan-configuration.rst

0 → 100644

+33 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/index.rst

0 → 100644

+103 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/multidomain-site-example/domains/alpha_centauri.conf

0 → 100644

+68 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/multidomain-site-example/i18n

0 → 120000

+1 −0

Original line number	Diff line number	Diff line
		../site-example/i18n/
		No newline at end of file

docs/multidomain-site-example/image-customization.lua

0 → 100644

+20 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/multidomain-site-example/modules

0 → 120000

+1 −0

Original line number	Diff line number	Diff line
		../site-example/modules
		No newline at end of file

docs/multidomain-site-example/site.conf

0 → 100644

+60 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/multidomain-site-example/site.mk

0 → 100644

+34 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-client-bridge.rst

0 → 100644

+11 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-config-mode-domain-select.rst

0 → 100644

+19 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-config-mode-geo-location-osm.png

0 → 100644

+345 KiB

345.47 KiB

docs/package/gluon-config-mode-geo-location-osm.rst

0 → 100644

+11 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-ebtables-filter-multicast.rst

0 → 100644

+30 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-ebtables-filter-ra-dhcp.rst

0 → 100644

+13 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-ebtables-limit-arp.rst

0 → 100644

+30 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-ebtables-source-filter.rst

0 → 100644

+33 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-harden-dropbear.rst

0 → 100644

+30 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-hoodselector-domainmap.jpeg

0 → 100644

+291 KiB

291.18 KiB

docs/package/gluon-hoodselector-rectangle-example.svg

0 → 100644

+16 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-hoodselector.dia

0 → 100644

+1080 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-hoodselector.rst

0 → 100644

+133 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-hoodselector.svg

0 → 100644

+291 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-logging.rst

0 → 100644

+37 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-mesh-batman-adv-brmldproxy.rst

0 → 100644

+41 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-mesh-batman-adv-logo.svg

0 → 100644

+25 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-mesh-batman-adv-multicast-architecture-segmentation.svg

0 → 100644

+246 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-mesh-batman-adv-multicast-architecture-to-clients.svg

0 → 100644

+232 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-mesh-batman-adv-multicast-architecture-to-mesh.svg

0 → 100644

+232 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-mesh-batman-adv-multicast-architecture.dia

0 → 100644

+2.2 KiB

File added.

Preview size limit exceeded, changes collapsed.

View file

docs/package/gluon-mesh-batman-adv-multicast.svg

0 → 100644

+44 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-mesh-batman-adv.rst

0 → 100644

+212 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-mesh-wireless-sae.rst

0 → 100644

+49 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-radv-filterd.rst

0 → 100644

+64 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-radvd.rst

0 → 100644

+34 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-scheduled-domain-switch.rst

0 → 100644

+34 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-state-check.rst

0 → 100644

+28 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-web-admin.rst

0 → 100644

+29 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-web-cellular.png

0 → 100644

+72 KiB

File added.

Preview size limit exceeded, changes collapsed.

View file

docs/package/gluon-web-cellular.rst

0 → 100644

+14 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-web-logging.rst

0 → 100644

+5 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/package/gluon-web-network.png

0 → 100644

+53.2 KiB

File added.

Preview size limit exceeded, changes collapsed.

View file

docs/package/gluon-web-network.rst

0 → 100644

+20 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/index.rst

0 → 100644

+148 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2014.3.1.rst

0 → 100644

+40 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2014.3.rst

0 → 100644

+136 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2014.4.rst

0 → 100644

+152 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2015.1.1.rst

0 → 100644

+27 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2015.1.2.rst

0 → 100644

+41 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2015.1.rst

0 → 100644

+252 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2016.1.1.rst

0 → 100644

+64 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2016.1.2.rst

0 → 100644

+29 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2016.1.3.rst

0 → 100644

+43 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2016.1.4.rst

0 → 100644

+46 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2016.1.5.rst

0 → 100644

+66 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2016.1.6.rst

0 → 100644

+55 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2016.1.rst

0 → 100644

+276 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2016.2.1.rst

0 → 100644

+59 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2016.2.2.rst

0 → 100644

+78 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2016.2.3.rst

0 → 100644

+62 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2016.2.4.rst

0 → 100644

+55 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2016.2.5.rst

0 → 100644

+36 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2016.2.6.rst

0 → 100644

+57 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2016.2.7.rst

0 → 100644

+31 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2016.2.rst

0 → 100644

+179 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2017.1.1.rst

0 → 100644

+41 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2017.1.2.rst

0 → 100644

+84 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2017.1.3.rst

0 → 100644

+65 −0

File added.

Preview size limit exceeded, changes collapsed.

Source

Target

Files

Some changes are not shown.