An error occurred while retrieving target projects.

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 since source was created

Commits on Source 3801

8e891b2c ebtables-filter-mcast: Remove redundant allow-filter for hop-by-hop
May 20, 2016
4199b216 ebtables-segment-mld: Segment IGMP/MLD domain
May 20, 2016
4c097837 docs: autoupdater's fallback option (#786)
May 26, 2016
f7eda938 respondd modules: Use proper formatting of doubles
May 26, 2016
22ec5f1c docs: fix 404 error for nordwest site repo url
May 26, 2016
76c34567 gluon-node-info: simplify respondd module code a bit
May 27, 2016
efc004ab scripts/patch: never GPG-sign automated commits, regardless of the default configuration
May 28, 2016
13465e93 node: downgrade to v0.12.14
May 28, 2016
9fc0dcdd Merge remote-tracking branch 'origin/doubles-fmt'
May 28, 2016
5c67b490 docs: added site for Regio Aachen
May 29, 2016
59d4b305 Update patches
May 29, 2016
b56b6640 mac80211: backport ath9k GPIO support
May 29, 2016
4becc7db Backport fixes for the WNR2200
May 29, 2016
60aaa426 ar71xx-generic: add support for NETGEAR WNR2200
May 29, 2016
8342294b sunxi: add Lamobo-R1
May 29, 2016
3f24aa24 docs: add documentation about site modules
May 29, 2016
0c8f637d ar71xx-generic: add D-Link DIR-505 rev. A2 as alias of D-Link DIR-505 rev. A1
May 29, 2016
ca7c71a5 node: fix build on Debian Jessie
May 29, 2016
5ea9c083 node: fix CXXFLAGS on host install
May 29, 2016
a852056c Update Gluon packages
May 31, 2016
0a936e4d gluon-batman-adv-core: respondd: add gateway_nexthop field
Jun 2, 2016
ffd1f0b3 ar71xx: backport fixes for better CPE210/510 support
Jun 9, 2016
1059a798 ar71xx: add GL-AR150 support
Jun 15, 2016
20e57a1c build: backport a few patches for better Make 4.2+ support
Jun 15, 2016
d7c1c7ff kernel: make IPv6 builtin
Jun 15, 2016
80751d9b kernel: change kmod-crypto-{core,arc4} to builtin
Jun 16, 2016
2b5bf4c2 Update OpenWrt and LuCI packages
Jun 16, 2016
04106989 Update routing packages
Jun 16, 2016
7a2dd8b3 Revert "ar71xx: backport fixes for better CPE210/510 support"
Jun 17, 2016
f640573b docs: Fix list alignment of OpenMesh devices
Jun 17, 2016
3ccd5169 ar71xx-generic: Add support for OpenMesh OM2P-HSv3
Jun 17, 2016
fa04fff8 ar71xx-generic: Add support for OpenMesh MR1750v2
Jun 17, 2016
93fe2750 batman-adv: Fix speedy join in gateway client mode
Jun 21, 2016
4251b4d4 Update Gluon packages
Jun 22, 2016
dc485f73 gluon-core: make gluon.platform.match() match all boards when no boards are given
Jun 22, 2016
acd5cc90 build: allow profiles to supply an additional file to be copied to the image directory
Jun 22, 2016
bae721a9 Add target ar71xx-mikrotik
Jun 22, 2016
fb8c7a8b sunxi: add Banana Pro (#802)
Jun 22, 2016
6b644df4 brcm2708-*: remove BROKEN
Jun 29, 2016
e678ab14 scripts/update-patches: disable rename detection
Jul 1, 2016
f1570cac ramips: add missing patch to spi-nor backport to fix mt7621 support
Jul 1, 2016
b4829fad Update gluon packages
Jul 1, 2016
0676f5f3 x86: stop relying on hexdump for image build signature
Jul 3, 2016
fd237f6f mac80211: update to LEDE 0a0caa2656c8db73518a1783743ede772e3ac40f
Jul 3, 2016
634997ec Add target ramips-mt7621 with model D-Link DIR-860L B1
Jul 3, 2016
267b9bd0 ar71xx-generic: add support for TP-Link TL-WR842N/ND v3 (untested)
Jul 3, 2016
a4b60a37 ar71xx-generic: fix TL-WR841N/ND v11 LEDs
Jul 3, 2016
4af46bdb batman-adv: import Linux 4.7 fixes
Jul 6, 2016
d0831aa8 Update routing packages
Jul 6, 2016
1a289341 build: add GluonSrcDiet define to package.mk
Jul 9, 2016
c913957e gluon-luci-wifi-config: fix to work with legacy configs using macaddr instead...
Jul 9, 2016
42910c06 ramips-mt7621: use phy1 MAC address as primary on DIR-860L B1
Jul 10, 2016
1c1f4905 Minify all Lua code
Jul 10, 2016
9ffdb0cd docs: user/site: clarify mirror ordering
Jul 10, 2016
0c7457f1 Update Gluon packages
Jul 19, 2016
8f5a7c90 gluon-mesh-batman-adv-core: stop WLAN and batman-adv before autoupdater upgrades
Jul 19, 2016
64fdc0d7 gluon-mesh-batman-adv-core: add sleep to autoupdater network stop script
Jul 19, 2016
91881f45 mac80211: update to LEDE 6c2651566cce8f5b3a3d3b976439dee2bac5e07e
Jul 19, 2016
b2117fd3 x86-generic: enable CONFIG_SATA_VIA
Jul 20, 2016
849af9ad gluon-client-bridge, gluon-mesh-batman-adv-core: simplify VIF config functions
Jul 20, 2016
c8bc4620 gluon-core: unify indentation in gluon/util.lua
Jul 20, 2016
2afe34ef Use MAC addresses provided by WLAN drivers by default
Jul 20, 2016
1c42aa0e libpcap: fix dependency of install-shared-so make target
Jul 21, 2016
8e8f794c gluon-neighbour-info: improve verbosity on wrong cli parameters (#829)
Jul 25, 2016
7a03c09e ar71xx-generic: add support for ALFA Networks Tube2H (#828)
Jul 25, 2016
55d6f71c gluon-setup-mode: remove unneeded require
Jul 25, 2016
7974284e mac80211: update to LEDE b47f438d98cd4b731d7f4431448dde973eae4739
Jul 25, 2016
aae05fe3 netifd: update to latest version from LEDE
Jul 26, 2016
65ee128c gluon-radvd: externalize arguments
Jul 26, 2016
0b0550c3 ar71xx-generic: fix names of ALFA products
Jul 26, 2016
5e3b1f80 gluon-luci-admin: regenerate fr.po
Jul 27, 2016
85674a55 gluon-luci-admin: rename "Expert Mode" to "Advanced settings"
Jul 27, 2016
fd80c4ea netifd: fix broken download URL
Jul 27, 2016
e773f686 ar71xx-generic: fix BOARDNAME for UAP AC Lite
Jul 27, 2016
0c63fc46 ar71xx-generic: fix Tube2H profile
Jul 27, 2016
7565839f Merge pull request #674 from T-X/filter-igmp-mld
Jul 27, 2016
806af270 gluon-client-bridge, gluon-mesh-batman-adv-core: make macaddr variable local in upgrade script
Jul 27, 2016
279a4091 gluon-core: split get_wlan_mac_from_driver() out of get_wlan_mac()
Jul 27, 2016
b2413736 gluon-luci-private-wifi: set MAC address if the driver provides one
Jul 27, 2016
cb2ecbfd Make libuecc a shared library, update Gluon packages
Jul 27, 2016
3d3eb24a ar71xx-generic: backport a few D-Link DIR-505 A1/A2 patches
Jul 28, 2016
f103ee24 Add support for Buffalo WZR-HP-G300NH2 (#836)
Jul 29, 2016
66a7542a netifd: update to latest version
Jul 29, 2016
284c61d9 mac80211, hostapd, iw, ...: update to LEDE b2ddfbc1c7b935cf931b4c336969b65947270ce9
Jul 29, 2016
f2feea2d contrib/lsupgrade.sh: show upgrade scripts in luasrc directories
Jul 29, 2016
b1a753e1 gluon-core: allow setting PoE passthrough default setting from site.conf
Jul 29, 2016
f3cb6d7b gluon-luci-portconfig: add setting for PoE passthrough
Jul 29, 2016
d445cb77 gluon-radvd: Use procd in init script
Jul 30, 2016
2789aebc gluon-luci-private-wifi: limit ssid to 32 characters (#848)
Aug 8, 2016
74f4a938 ar71xx-generic: verified Tube2h, remove BROKEN (#847)
Aug 8, 2016
93deaad8 modules: change url from openwrt.org to github one (#850)
Aug 8, 2016
bb3db179 update/patch: avoid applying patches directly in build repos
Aug 9, 2016
98557891 mac80211, hostapd, iw, ...: update to LEDE 27dffa0b0c53a1a817a9a37d1647c7e70672273f
Aug 9, 2016
0eac1029 scripts/update.sh: fix checkout of correct base commit after fetching
Aug 12, 2016
65549888 ar71xx-generic: remove broken mark for wr842n-v3 (#859)
Aug 22, 2016
934f640b Docs: more example site configs in the wild (#837)
Aug 22, 2016
61cde569 ar71xx: backport fixes for better CPE210/510 support (again)
Aug 22, 2016
b00c1a30 dropbear: update to LEDE 277f85c21ae0ede4e15e66cbd801b9fb502531df
Aug 22, 2016
d5829d87 gluon-mesh-batman-adv-core: disable bridge port learning on bat0 (#780)
Aug 22, 2016
2a51d94f gluon-mesh-batman-adv-core: reenable multicast snooping
Aug 22, 2016

3,701 additional commits have been omitted to prevent performance issues.

Some changes are not shown.

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

.ecrc

0 → 100644

+3 −0

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

.editorconfig

0 → 100644

+67 −0

Original line number	Original line	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	Original line	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	Original line	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	Original line	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	Original line	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	Original line	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	Original line	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	Original line	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	Original line	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	Original line	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	Original line	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	Original line	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	Original line	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	Original line	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

+6 −3

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

.luacheckrc

0 → 100644

+119 −0

Original line number	Original line	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	Original line	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

+9 −25

Original line number	Original line	Diff line number	Diff line
	@@ -23,19 +23,19 @@ 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		They might even refuse the idea altogether - after all, they have to sleep well
	after merging the changes, too.		after merging the changes, too.

	The preferred way to discuss in the IRC channel ([#gluon] on irc.hackint.org)		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		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		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		kindly ask you to review it first. In general, looking for duplicates may save
	you some time.		you some time.

	Develop on top of master		Develop on top of main
	------------------------		----------------------
	If you are not developing something specific to a release (like for example a		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),		security fix to a feature that got completely rewritten since the release),
	develop it on top of the master branch. New features and even feature changes		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		aren't usually backported to old releases, but will be included in the upcoming
	release, which will be built from master.		release, which will be built from main.

	Use descriptive commit messages		Use descriptive commit messages
	-------------------------------		-------------------------------
	@@ -46,24 +46,8 @@ 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		triggered and what you did to fix it. If in question, have a glance at the
	existing commit messages to get the idea.		existing commit messages to get the idea.

	Squash commits
	--------------
	Most changes are trivial enough to fit in one single commit in order to not
	clutter the history. While developing a new feature, you are free to use
	multiple commits, but if your feature is to be merged, reduce the number of
	commits to a minimum. Even huge feature introductions like the 802.11s mesh
	(commit [2a93c58]) fit into a single commit.

	If you developed your change in multiple smaller commits, you can easily		[packages]: https://gluon.readthedocs.io/en/latest/user/site.html#packages
	[squash] those before opening the pull request. While discussing, it is okay to		[#gluon]: https://chat.hackint.org/?join=gluon
	do your changes using `git commit --amend` and force-push them to your head of
	the pull request. This way, your change always consists of only one commit and
	can be merged in the instant everybody is content with the whole thing.


	[packages]: http://gluon.readthedocs.org/en/latest/user/site.html#packages
	[#gluon]: https://webirc.hackint.org/#gluon
	[mailing list]: mailto:gluon@luebeck.freifunk.net		[mailing list]: mailto:gluon@luebeck.freifunk.net
	[list of rejected features]: https://github.com/freifunk-gluon/gluon/issues?q=label%3Arejected		[list of rejected features]: https://github.com/freifunk-gluon/gluon/issues?q=label%3A%222.+status%3A+rejected%22
	[2a93c58]: https://github.com/freifunk-gluon/gluon/commit/2a93c580428d10724116b0d2d1238e2745715a14
	[squash]: https://www.git-scm.com/book/en/v2/Git-Tools-Rewriting-History#Squashing-Commits

LICENSE

+6 −3

Original line number	Original line	Diff line number	Diff line
			BSD 2-Clause License

	The code of Project Gluon may be distributed under the following terms, unless		The code of Project Gluon may be distributed under the following terms, unless
	noted otherwise in individual files or subtrees.		noted otherwise in individual files or subtrees.

	Copyright (c) 2013, Project Gluon		Copyright (c) Project Gluon
	All rights reserved.		All rights reserved.

	Redistribution and use in source and binary forms, with or without		Redistribution and use in source and binary forms, with or without
	@@ -26,8 +28,9 @@ 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,		OpenWrt is licensed under the terms of the GNU General Public License Version 2,
	which can be found under openwrt/LICENSE after the openwrt submodule has been		which can be found at openwrt/LICENSE after the OpenWrt repository has been
	obtained. This applies to the following submodules:		obtained. This applies to the following repositories:

	* openwrt		* openwrt
	* packages/openwrt		* packages/openwrt
	* packages/routing		* packages/routing

Makefile

+191 −435

File changed.

Preview size limit exceeded, changes collapsed.

README.md

+50 −10

Original line number	Original line	Diff line number	Diff line
	Documentation (incomplete at this time, contribute if you can!) may be found at		[![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)
	http://gluon.readthedocs.org/.		[![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		If you're new to Gluon and ready to get your feet wet, have a look at the
	[Getting Started Guide](http://gluon.readthedocs.org/en/latest/user/getting_started.html).		[Getting Started Guide](https://gluon.readthedocs.io/en/latest/user/getting_started.html).

	Gluon IRC channel: `#gluon` in [hackint](http://hackint.org/)		Gluon's developers frequent an IRC chatroom at [#gluon](ircs://irc.hackint.org/#gluon)
			on [hackint](https://hackint.org/). There is also a [webchat](https://chat.hackint.org/?join=gluon)
			that allows for uncomplicated access from within your browser. This channel is also available as a bridged Matrix Room at [#gluon:hackint.org](https://matrix.to/#/#gluon:hackint.org).

	## Issues & Feature requests		## Issues & Feature requests

	@@ -17,22 +57,22 @@ the future development of Gluon.

	## Use a release!		## Use a release!

	Please refrain from using the `master` branch for anything else but development purposes!		Please refrain from using the `main` branch for anything else but development purposes!
	Use the most recent release instead. You can list all relaseses by running `git branch -a`		Use the most recent release instead. You can list all releases by running `git tag`
	and switch to one by running `git checkout v2016.1.5 && make update`.		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're using the autoupdater, do not autoupdate nodes with anything but releases.
	If you upgrade using random master commits the nodes will break eventually.		If you upgrade using random main commits the nodes might break eventually.

	## Mailinglist		## Mailinglist

	To subscribe to the list, send a message to:		To subscribe to the list, send a message to:

	gluon-subscribe@luebeck.freifunk.net		gluon+subscribe@luebeck.freifunk.net

	To remove your address from the list, just send a message to		To remove your address from the list, just send a message to
	the address in the `List-Unsubscribe` header of any list		the address in the `List-Unsubscribe` header of any list
	message. If you haven't changed addresses since subscribing,		message. If you haven't changed addresses since subscribing,
	you can also send a message to:		you can also send a message to:

	gluon-unsubscribe@luebeck.freifunk.net		gluon+unsubscribe@luebeck.freifunk.net

contrib/actions/free-runner-space.sh

0 → 100755

+23 −0

Original line number	Original line	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	Original line	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	Original line	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	Original line	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	Original line	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	Original line	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	Original line	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	Original line	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	Original line	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	Original line	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	Original line	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	Original line	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	Original line	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	Original line	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	Original line	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

+26 −13

Original line number	Original line	Diff line number	Diff line
	#!/bin/bash		#!/usr/bin/env bash

	# Script to output the dependency graph of Gluon's packages		# Script to output the dependency graph of Gluon's packages
	# Limitations:		# Limitations:
	# * Works only if directory names and package names are the same (true for all Gluon packages)
	# * Doesn't show dependencies through virtual packages correctly		# * Doesn't show dependencies through virtual packages correctly

			set -e

	shopt -s nullglob		shopt -s nullglob


	@@ -25,19 +23,34 @@ print_dep() {
	echo "$(escape_name "$1") -> $(escape_name "$2");"		echo "$(escape_name "$1") -> $(escape_name "$2");"
	}		}

	echo 'digraph G {'		print_package() {
			local package="$1" depends="$2"
	for makefile in ./package/*/Makefile; do		# shellcheck disable=SC2086
	dir="$(dirname "$makefile")"		set -- $depends
	package="$(basename "$dir")"

	deps=$(grep -w DEPENDS "$makefile" \| cut -d= -f2 \| tr -d +)

	print_node "$package"		print_node "$package"
	for dep in $deps; do		for dep in "$@"; do
	print_node "$dep"		print_node "$dep"
	print_dep "$package" "$dep"		print_dep "$package" "$dep"
	done		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		done \| sort -u

	popd >/dev/null		popd >/dev/null

contrib/docker/Dockerfile

0 → 100644

+47 −0

Original line number	Original line	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	Original line	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

+11 −7

Original line number	Original line	Diff line number	Diff line
	#!/bin/bash		#!/usr/bin/env bash

			set -e
	# Script to list all upgrade scripts in a clear manner		# Script to list all upgrade scripts in a clear manner
	# Limitations:		# Limitations:
	# * Does only show scripts of packages whose `files' directory represent the whole image filesystem (which are all Gluon packages)		# * Does only show scripts of packages whose `files'/`luasrc' directories represent the whole image filesystem (which are all Gluon packages)


	SUFFIX=files/lib/gluon/upgrade		SUFFIX1=files/lib/gluon/upgrade
			SUFFIX2=luasrc/lib/gluon/upgrade


	shopt -s nullglob		shopt -s nullglob
	@@ -26,7 +28,7 @@ fi

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

	find ./package packages -name Makefile \| while read makefile; do		find ./package packages -name Makefile \| grep -v '^packages/packages/' \| while read -r makefile; do
	dir="$(dirname "$makefile")"		dir="$(dirname "$makefile")"

	pushd "$dir" >/dev/null		pushd "$dir" >/dev/null
	@@ -35,10 +37,12 @@ find ./package packages -name Makefile \| while read makefile; do
	dirname="$(dirname "$dir" \| cut -d/ -f 3-)"		dirname="$(dirname "$dir" \| cut -d/ -f 3-)"
	package="$(basename "$dir")"		package="$(basename "$dir")"

	for file in "${SUFFIX}"/*; do		for file in "${SUFFIX1}"/* "${SUFFIX2}"/*; do
	echo "${GREEN}$(basename "${file}")${RESET}" "(${BLUE}${repo}${RESET}/${dirname}${dirname:+/}${RED}${package}${RESET}/${SUFFIX})"		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		done
	popd >/dev/null		popd >/dev/null
	done \| sort		done \| sort \| cut -f2-

	popd >/dev/null		popd >/dev/null

contrib/push_pkg.sh

0 → 100755

+149 −0

Original line number	Original line	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	Original line	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

+18 −7

Original line number	Original line	Diff line number	Diff line
	@@ -2,7 +2,7 @@

	set -e		set -e

	if [ $# -ne 2 -o "-h" = "$1" -o "--help" = "$1" -o ! -r "$1" -o ! -r "$2" ]; then		if [ $# -ne 2 ] \|\| [ "-h" = "$1" ] \|\| [ "--help" = "$1" ] \|\| [ ! -r "$1" ] \|\| [ ! -r "$2" ]; then
	cat <<EOHELP		cat <<EOHELP
	Usage: $0 <secret> <manifest>		Usage: $0 <secret> <manifest>

	@@ -15,7 +15,7 @@ The script may be performed multiple times to the same document
	to indicate an approval by multiple developers.		to indicate an approval by multiple developers.

	See also		See also
	* edcsautils on https://github.com/tcatm/ecdsautils		* ecdsautils on https://github.com/freifunk-gluon/ecdsautils

	EOHELP		EOHELP
	exit 1		exit 1
	@@ -29,11 +29,22 @@ lower="$(mktemp)"

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

	awk 'BEGIN { sep=0 }		awk 'BEGIN {
	/^---$/ { sep=1; next }		sep = 0
	{ if(sep==0) print > "'"$upper"'";		}
	else print > "'"$lower"'"}' \
	"$manifest"		/^---$/ {
			sep = 1;
			next
			}

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

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

contrib/sigtest.sh

+26 −15

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

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

	@@ -8,8 +8,8 @@ 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.		no output, success or failure is indicated via the return code.

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

	EOHELP		EOHELP
	exit 1		exit 1
	@@ -21,13 +21,24 @@ upper="$(mktemp)"
	lower="$(mktemp)"		lower="$(mktemp)"
	ret=1		ret=1

	awk "BEGIN { sep=0 }		awk 'BEGIN {
	/^---\$/ { sep=1; next }		sep = 0
	{ if(sep==0) print > \"$upper\";		}
	else print > \"$lower\"}" \
	"$manifest"

	while read line		/^---$/ {
			sep = 1;
			next
			}

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

			while read -r line
	do		do
	if ecdsaverify -s "$line" -p "$public" "$upper"; then		if ecdsaverify -s "$line" -p "$public" "$upper"; then
	ret=0		ret=0

docs/Makefile

+10 −168

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

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

	# User-friendly check for sphinx-build		# Put it first so that "make" without argument is like "make help".
	ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
	$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
	endif

	# Internal variables.
	PAPEROPT_a4 = -D latex_paper_size=a4
	PAPEROPT_letter = -D latex_paper_size=letter
	ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
	# the i18n builder cannot share the environment and doctrees with the others
	I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .

	.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext

	help:		help:
	@echo "Please use \`make <target>' where <target> is one of"		@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
	@echo " html to make standalone HTML files"
	@echo " dirhtml to make HTML files named index.html in directories"
	@echo " singlehtml to make a single large HTML file"
	@echo " pickle to make pickle files"
	@echo " json to make JSON files"
	@echo " htmlhelp to make HTML files and a HTML help project"
	@echo " qthelp to make HTML files and a qthelp project"
	@echo " devhelp to make HTML files and a Devhelp project"
	@echo " epub to make an epub"
	@echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
	@echo " latexpdf to make LaTeX files and run them through pdflatex"
	@echo " latexpdfja to make LaTeX files and run them through platex/dvipdfmx"
	@echo " text to make text files"
	@echo " man to make manual pages"
	@echo " texinfo to make Texinfo files"
	@echo " info to make Texinfo files and run them through makeinfo"
	@echo " gettext to make PO message catalogs"
	@echo " changes to make an overview of all changed/added/deprecated items"
	@echo " xml to make Docutils-native XML files"
	@echo " pseudoxml to make pseudoxml-XML files for display purposes"
	@echo " linkcheck to check all external links for integrity"
	@echo " doctest to run all doctests embedded in the documentation (if enabled)"

	clean:
	rm -rf $(BUILDDIR)/*

	html:
	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
	@echo
	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."

	dirhtml:
	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
	@echo
	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."

	singlehtml:
	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
	@echo
	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."

	pickle:
	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
	@echo
	@echo "Build finished; now you can process the pickle files."

	json:
	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
	@echo
	@echo "Build finished; now you can process the JSON files."

	htmlhelp:
	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
	@echo
	@echo "Build finished; now you can run HTML Help Workshop with the" \
	".hhp project file in $(BUILDDIR)/htmlhelp."

	qthelp:
	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
	@echo
	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
	".qhcp project file in $(BUILDDIR)/qthelp, like this:"
	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/Gluon.qhcp"
	@echo "To view the help file:"
	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/Gluon.qhc"

	devhelp:
	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
	@echo
	@echo "Build finished."
	@echo "To view the help file:"
	@echo "# mkdir -p $$HOME/.local/share/devhelp/Gluon"
	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/Gluon"
	@echo "# devhelp"

	epub:
	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
	@echo
	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."

	latex:
	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
	@echo
	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
	@echo "Run \`make' in that directory to run these through (pdf)latex" \
	"(use \`make latexpdf' here to do that automatically)."

	latexpdf:
	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
	@echo "Running LaTeX files through pdflatex..."
	$(MAKE) -C $(BUILDDIR)/latex all-pdf
	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."

	latexpdfja:
	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
	@echo "Running LaTeX files through platex and dvipdfmx..."
	$(MAKE) -C $(BUILDDIR)/latex all-pdf-ja
	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."

	text:
	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
	@echo
	@echo "Build finished. The text files are in $(BUILDDIR)/text."

	man:
	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
	@echo
	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."

	texinfo:
	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
	@echo
	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
	@echo "Run \`make' in that directory to run these through makeinfo" \
	"(use \`make info' here to do that automatically)."

	info:
	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
	@echo "Running Texinfo files through makeinfo..."
	make -C $(BUILDDIR)/texinfo info
	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."

	gettext:
	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
	@echo
	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."

	changes:
	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
	@echo
	@echo "The overview file is in $(BUILDDIR)/changes."

	linkcheck:
	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
	@echo
	@echo "Link check complete; look for any errors in the above output " \
	"or in $(BUILDDIR)/linkcheck/output.txt."

	doctest:
	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
	@echo "Testing of doctests in the sources finished, look at the " \
	"results in $(BUILDDIR)/doctest/output.txt."

	xml:		.PHONY: help Makefile
	$(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
	@echo
	@echo "Build finished. The XML files are in $(BUILDDIR)/xml."

	pseudoxml:		# Catch-all target: route all unknown targets to Sphinx using the new
	$(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml		# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
	@echo		%: Makefile
	@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."		@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/_static/css/custom.css

0 → 100644

+3 −0

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

docs/conf.py

+102 −175

Original line number	Original line	Diff line number	Diff line
	#!/usr/bin/env python3
	# -- coding: utf-8 --		# -- coding: utf-8 --
	#		#
	# Gluon documentation build configuration file, created by		# Configuration file for the Sphinx documentation builder.
	# sphinx-quickstart on Wed Jan 29 00:45:53 2014.
	#		#
	# This file is execfile()d with the current directory set to its		# This file does only contain a selection of the most common options. For a
	# containing dir.		# full list see the documentation:
	#		# http://www.sphinx-doc.org/en/master/config
	# Note that not all possible configuration values are present in this
	# autogenerated file.
	#
	# All configuration values have a default; values that are commented out
	# serve to show the default.

	import sys		# -- Path setup --------------------------------------------------------------
	import os

	# If extensions (or modules to document with autodoc) are in another directory,		# 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		# 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.		# documentation root, use os.path.abspath to make it absolute, like shown here.
			#
			# import os
			# import sys
	# sys.path.insert(0, os.path.abspath('.'))		# sys.path.insert(0, os.path.abspath('.'))

	# -- General configuration ------------------------------------------------
			# -- 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.		# If your documentation needs a minimal Sphinx version, state it here.
			#
	# needs_sphinx = '1.0'		# needs_sphinx = '1.0'

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

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

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

	# The master toctree document.		# The master toctree document.
	master_doc = 'index'		master_doc = 'index'

	# General information about the project.
	project = 'Gluon'
	copyright = '2015-2016, Project Gluon'

	# The version info for the project you're documenting, acts as replacement for
	# \|version\| and \|release\|, also used in various other places throughout the
	# built documents.
	#
	# The short X.Y version.
	version = '2016.1+'
	# The full version, including alpha/beta/rc tags.
	release = '2016.1+'

	# The language for content autogenerated by Sphinx. Refer to documentation		# The language for content autogenerated by Sphinx. Refer to documentation
	# for a list of supported languages.		# for a list of supported languages.
	#language = None		#
			# This is also used if you do content translation via gettext catalogs.
	# There are two options for replacing \|today\|: either, you set today to some		# Usually you set "language" from the command line for these cases.
	# non-false value, then it is used:		language = 'en'
	#today = ''
	# Else, today_fmt is used as the format for a strftime call.
	#today_fmt = '%B %d, %Y'

	# List of patterns, relative to source directory, that match files and		# List of patterns, relative to source directory, that match files and
	# directories to ignore when looking for source files.		# directories to ignore when looking for source files.
	exclude_patterns = ['_build']		# This pattern also affects html_static_path and html_extra_path.
			exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
	# The reST default role (used for this markup: `text`) to use for all
	# documents.
	#default_role = None

	# If true, '()' will be appended to :func: etc. cross-reference text.
	#add_function_parentheses = True

	# If true, the current module name will be prepended to all description
	# unit titles (such as .. function::).
	#add_module_names = True

	# If true, sectionauthor and moduleauthor directives will be shown in the
	# output. They are ignored by default.
	#show_authors = False

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

	# A list of ignored prefixes for module index sorting.		# Don't highlight code blocks unless requested explicitly
	#modindex_common_prefix = []		highlight_language = 'none'

	# If true, keep warnings as "system message" paragraphs in the built documents.		# Ignore links to the config mode, as well as anchors on on hackint, which are
	#keep_warnings = False		# 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 ----------------------------------------------		# -- Options for HTML output -------------------------------------------------

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

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

	# Add any paths that contain custom themes here, relative to this directory.
	#html_theme_path = []

	# The name for this set of Sphinx documents. If None, it defaults to
	# "<project> v<release> documentation".
	#html_title = None

	# A shorter title for the navigation bar. Default is the same as html_title.
	#html_short_title = None

	# The name of an image file (relative to this directory) to place at the top
	# of the sidebar.
	#html_logo = None

	# The name of an image file (within the static path) to use as favicon of the
	# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32
	# pixels large.
	#html_favicon = None

	# Add any paths that contain custom static files (such as style sheets) here,		# 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,		# relative to this directory. They are copied after the builtin static files,
	# so a file named "default.css" will overwrite the builtin "default.css".		# so a file named "default.css" will overwrite the builtin "default.css".
	#html_static_path = ['_static']		#
			html_static_path = ['_static']
	# Add any extra paths that contain custom files (such as robots.txt or
	# .htaccess) here, relative to this directory. These files are copied
	# directly to the root of the documentation.
	#html_extra_path = []

	# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
	# using the given strftime format.
	#html_last_updated_fmt = '%b %d, %Y'

	# If true, SmartyPants will be used to convert quotes and dashes to
	# typographically correct entities.
	#html_use_smartypants = True

	# Custom sidebar templates, maps document names to template names.		# 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 = {}		# html_sidebars = {}

	# Additional templates that should be rendered to pages, maps page names to		# These paths are either relative to html_static_path
	# template names.		# or fully qualified paths (eg. https://...)
	#html_additional_pages = {}		html_css_files = ['css/custom.css']

	# If false, no module index is generated.
	#html_domain_indices = True

	# If false, no index is generated.
	#html_use_index = True

	# If true, the index is split into individual pages for each letter.		# -- Options for HTMLHelp output ---------------------------------------------
	#html_split_index = False

	# If true, links to the reST sources are added to the pages.
	#html_show_sourcelink = True

	# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
	#html_show_sphinx = True

	# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
	#html_show_copyright = True

	# If true, an OpenSearch description file will be output, and all pages will
	# contain a <link> tag referring to it. The value of this option must be the
	# base URL from which the finished HTML is served.
	#html_use_opensearch = ''

	# This is the file name suffix for HTML files (e.g. ".xhtml").
	#html_file_suffix = None

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


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

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

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

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

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

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

	# The name of an image file (relative to this directory) to place at the top of
	# the title page.
	#latex_logo = None

	# For "manual" documents, if this is true, then toplevel headings are parts,
	# not chapters.
	#latex_use_parts = False

	# If true, show page references after internal links.
	#latex_show_pagerefs = False

	# If true, show URL addresses after external links.
	#latex_show_urls = False

	# Documents to append as an appendix to all manuals.
	#latex_appendices = []

	# If false, no module index is generated.		# -- Options for manual page output ------------------------------------------
	#latex_domain_indices = True


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

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

	# If true, show URL addresses after external links.
	#man_show_urls = False

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

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

	# Documents to append as an appendix to all manuals.
	#texinfo_appendices = []

	# If false, no module index is generated.		# -- Options for Epub output -------------------------------------------------
	#texinfo_domain_indices = True
			# Bibliographic Dublin Core info.
			epub_title = project

	# How to display URL addresses: 'footnote', 'no', or 'inline'.		# The unique identifier of the text. This can be a ISBN number
	#texinfo_show_urls = 'footnote'		# or the project homepage.
			#
			# epub_identifier = ''

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

	# If true, do not generate a @detailmenu in the "Top" node's menu.		# A list of files that should not be packed into the epub file.
	#texinfo_no_detailmenu = False		epub_exclude_files = ['search.html']

docs/dev/basics.rst

+42 −20

Original line number	Original line	Diff line number	Diff line
	@@ -15,10 +15,15 @@ The `main repo`_ does have issues enabled.
	IRC		IRC
	---		---

	Gluon's developers frequent `#gluon on hackint`_. You're welcome to join us!		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 on hackint: irc://irc.hackint.org/#gluon		.. _#gluon: ircs://irc.hackint.org/#gluon
			.. _hackint: https://hackint.org/
			.. _webchat: https://chat.hackint.org/?join=gluon

			.. _working-with-repositories:

	Working with repositories		Working with repositories
	-------------------------		-------------------------
	@@ -32,23 +37,9 @@ rerun

	`make update` also applies the patches that can be found in the directories found in		`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`		`patches`; the resulting branch will be called `patched`, while the commit specified in `modules`
	can be refered to by the branch `base`.		can be referred to by the branch `base`.

	::		After new patches have been committed on top of the `patched` branch (or existing commits

	make unpatch

	sets the repositories to the `base` branch,

	::

	make patch

	re-applies the patches by resetting the `patched` branch to `base` and calling `git am`
	for the patch files. Calling `make` or a similar command after calling `make unpatch`
	is generally not a good idea.

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

	@@ -61,3 +52,34 @@ and you can try rebasing it onto the new `base` branch yourself and after that c

	Always call `make update-patches` after making changes to a module repository as `make update` will overwrite your		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!		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	Original line	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/configmode.rst

deleted100644 → 0

+0 −92

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

	As of 2014.4 `gluon-config-mode` consists of several modules.

	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.

	gluon-config-mode-autoupdater
	Informs whether the autoupdater is enabled.

	gluon-config-mode-mesh-vpn
	Allows toggling of mesh-vpn-fastd and setting a bandwidth limit.

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

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

	In order to get a config mode close to the one found in 2014.3.x you may add
	these modules to your `site.mk`:
	gluon-config-mode-hostname,
	gluon-config-mode-autoupdater,
	gluon-config-mode-mesh-vpn,
	gluon-config-mode-geo-location,
	gluon-config-mode-contact-info

	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. If you take the standard set of modules, the
	order is, for wizard modules:

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

	While for reboot modules it is:

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

	Wizards
	-------

	Wizard modules return a UCI section. A simple module capable of changing the
	hostname might look like this::

	local cbi = require "luci.cbi"
	local uci = luci.model.uci.cursor()

	local M = {}

	function M.section(form)
	local s = form:section(cbi.SimpleSection, nil, nil)
	local o = s:option(cbi.Value, "_hostname", "Hostname")
	o.value = uci:get_first("system", "system", "hostname")
	o.rmempty = false
	o.datatype = "hostname"
	end

	function M.handle(data)
	uci:set("system", uci:get_first("system", "system"), "hostname", data._hostname)
	uci:save("system")
	uci:commit("system")
	end

	return M

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

	Reboot modules return a function that will be called when the page is to be
	rendered or nil (i.e. the module is skipped)::

	if no_hello_world_today then
	return nil
	else
	return function ()
	luci.template.render_string("Hello World!")
	end
	end

docs/dev/debugging.rst

0 → 100644

+51 −0

Original line number	Original line	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

+225 −71

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

	Hardware requirements		Hardware requirements
	---------------------		---------------------
	Having an ath9k (or ath10k) based WLAN adapter is highly recommended,		Having an ath9k, ath10k or mt76 based WLAN adapter is highly recommended,
	although other chipsets may also work. VAP (multiple SSID) support		although other chipsets may also work. VAP (multiple SSID) support
	is a requirement. At the moment, Gluon's scripts can't handle devices		with simultaneous AP + Mesh Point (802.11s) operation is required.
	without WLAN adapters (although such environments may also be interesting,
	e.g. for automated testing in virtual machines).

	.. _hardware-adding-profiles:		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.

	Adding profiles		.. _device-class-definition:
	---------------
	The vast majority of devices with ath9k WLAN uses the ar71xx target of OpenWrt.
	If the hardware you want to add support for is also ar71xx, adding a new profile
	is enough.

	Profiles are defined in ``targets/<target>-<subtarget>/profiles.mk``. There are two macros		Device classes
	used to define which images are generated: ``GluonProfile`` and ``GluonModel``. The following examples		--------------
	are taken from ``profiles.mk`` of the ``ar71xx-generic`` target::		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.

	$(eval $(call GluonProfile,TLWR1043))		There are currently two devices classes defined: "standard" and "tiny". The
	$(eval $(call GluonModel,TLWR1043,tl-wr1043nd-v1-squashfs,tp-link-tl-wr1043n-nd-v1))		"tiny" class contains all devices that do not meet the following requirements:
	$(eval $(call GluonModel,TLWR1043,tl-wr1043nd-v2-squashfs,tp-link-tl-wr1043n-nd-v2))

	The ``GluonProfile`` macro takes at least one parameter, the profile name as it is		- At least 7 MiB of usable firmware space
	defined in the Makefiles of OpenWrt (``openwrt/target/linux/<target>/<subtarget>/profiles/*``		- At least 64 MiB of RAM (128MiB for devices with ath10k radio)
	and ``openwrt/target/linux/<target>/image/Makefile``). If the target you are on doesn't define
	profiles (e.g. on x86), just add a single profile called ``Generic`` or similar.		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``.

	It may optionally take a second parameter which defines additional packages to include for the profile		The target configuration language is based on Lua, so Lua's syntax for variables
	(e.g. ath10k). The additional packages defined in ``openwrt/target/linux/<target>/<subtarget>/profiles/*``		and control structures can be used.
	aren't used.

	The ``GluonModel`` macro takes three parameters: The profile name, the suffix of the image file		Device definitions
	generated by OpenWrt (without the file extension), and the final image name of the Gluon image.		~~~~~~~~~~~~~~~~~~
	The final image name must be the same that is returned by the following command.		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
	lua -e 'print(require("platform_info").get_image_name())'
			device('tp-link-tl-wdr3600-v1', 'tplink_tl-wdr3600-v1')

	This is just so the autoupdater can work. The command has to be executed _on_ the target (eg. the hardware router with a flashed image). So you'll first have to build an image with a guessed name, and afterwards build a new, correctly named image. On targets which aren't supported by the autoupdater,		The first argument is the device name in Gluon, which is part of the output
	``require("platform_info").get_image_name()`` will just return ``nil`` and the final image name		image filename, and must correspond to the model string looked up by the
	may be defined arbitrarily.		autoupdater. The second argument is the corresponding device profile name in
			OpenWrt, as found in ``openwrt/target/linux/<target>/image/*``.
	On devices with multiple WLAN adapters, care must also be taken that the primary MAC address is
	configured correctly. ``/lib/gluon/core/sysconfig/primary_mac`` should contain the MAC address which		A table of additional settings can be passed as a third argument:
	can be found on a label on most hardware; if it does not, ``/lib/gluon/upgrade/010-primary-mac``
	in ``gluon-core`` might need a fix. (There have also been cases in which the address was incorrect		.. code-block:: lua
	even on devices with only one WLAN adapter, in these cases an OpenWrt bug was the cause).
			device('ubiquiti-edgerouter-x', 'ubnt_edgerouter-x', {
	Adding support for new hardware targets		factory = false,
	---------------------------------------		packages = {'-hostapd-mini'},
	Adding a new target is much more complex than adding a new profile. There are two basic steps		manifest_aliases = {
	required for adding a new target:		'ubnt-erx',
			},
	Adjust packages		})
	'''''''''''''''
	One package that definitely needs adjustments for every new target added is ``lua-platform-info``. Just		The supported additional settings are described in the following sections.
	start with a copy of an existing platform info script, adjust it for the new target, and add the new target
	to the list of supported targets in the package Makefile.		Suffixes and extensions
			~~~~~~~~~~~~~~~~~~~~~~~
	On many targets, Gluon's network setup scripts (mainly in the packages ``gluon-core`` and ``gluon-mesh-batman-adv-core``)		For many targets, OpenWrt generates images with the suffixes
	won't run correctly without some adjustments, so better double check that everything is fine there (and the files		``-squashfs-factory.bin`` and ``-squashfs-sysupgrade.bin``. For devices with
	``primary_mac``, ``lan_ifname`` and ``wan_ifname`` in ``/lib/gluon/core/sysconfig/`` contain sensible values).		different image names, is it possible to override the suffixes and extensions
			using the settings ``factory``, ``factory_ext``, ``sysupgrade`` and
	Add support to the build system		``sysupgrade_ext``, for example:
	'''''''''''''''''''''''''''''''
	A directory for the new target must be created under ``targets``, and it must be added		.. code-block:: lua
	to ``targets/targets.mk``. In the new target directory, the following files must be created:
			{
	* profiles.mk		factory = '-squashfs-combined',
	* config (optional)		factory_ext = '.img.gz',
			sysupgrade = '-squashfs-combined',
	For ``profiles.mk``, see :ref:`hardware-adding-profiles`.		sysupgrade_ext = '.img.gz',
	The file ``config`` can be used to add additional, target-specific options to the OpenWrt config.		}

	After this, is should be sufficient to call ``make GLUON_TARGET=<target>`` to build the images for the new target.		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/i18n.rst

deleted100644 → 0

+0 −88

Original line number	Original line	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 be fully translatable. English texts are required, German texts recommended.
	* 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 LuCI
	--------------------

	Internationalization support can be found in the ``luci.i18n`` package.
	Strings are translated using the ``i18n.translate`` and ``i18n.translatef`` functions
	(``translate`` for static strings, ``translatef`` for printf-like formatted string).

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

	local i18n = require "luci.i18n"
	o = s:option(cbi.Flag, "_location", i18n.translate("Show node on the map"))

	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 from the LuCI repository::

	cd package/gluon-config-mode-geo-location
	mkdir i18n
	cd i18n
	../../../packages/luci/build/i18n-scan.pl ../files > gluon-config-mode-geo-location.pot

	The entries in the template can be reordered after the generation if desirable. Lots of standard
	translations like "Cancel" are already available in the LuCI base translation file (see
	``packages/luci/po/templates/base.pot``) and can be removed from the template.

	In addition, some additions to the Makefile must be made. Instead of OpenWrt's default package.mk,
	the Gluon version ``$(GLUONDIR)/include/package.mk`` must be used. The i18n files must be installed
	and PKG_CONFIG_DEPENDS must be added::

	...
	include $(GLUONDIR)/include/package.mk

	PKG_CONFIG_DEPENDS += $(GLUON_I18N_CONFIG)
	...
	define Build/Compile
	$(call GluonBuildI18N,gluon-config-mode-geo-location,i18n)
	endef

	define Package/gluon-config-mode-geo-location/install
	...
	$(call GluonInstallI18N,gluon-config-mode-geo-location,$(1))
	endef
	...


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

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

	cd package/gluon-config-mode-geo-location/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::

	msgmerge -U de.po gluon-config-mode-geo-location.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 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 LuCI can be found in the ``packages/luci/luci.mk`` file after
	Gluon's dependencies have been downloaded using ``make update``. Adding translations for these
	languages is straightforward using the ``msginit`` command.

	For other languages, support must be added tu LuCI first, which constitutes completely translating
	the ``base.pot``. Please contact the upstream LuCI maintainers if you'd like to do this.

docs/dev/mac_addresses.rst

0 → 100644

+18 −0

Original line number	Original line	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	Original line	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	Original line	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

+5 −7

docs/dev/wan.rst→docs/dev/uplink.rst

+10 −4

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

	As the WAN port of a node will be connected to a user's private network, it		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.		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:		There are two cases in which the WAN port is used:

	* Mesh VPN (package ``gluon-mesh-vpn-fastd``		* Mesh VPN (package ``gluon-mesh-vpn-fastd``)
	* DNS to resolve the VPN servers' addresses (package ``gluon-wan-dnsmasq``)		* 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		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.		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		Routing tables
	~~~~~~~~~~~~~~		~~~~~~~~~~~~~~
	@@ -46,4 +52,4 @@ 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.		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		The package ``gluon-mesh-vpn-fastd`` provides an iptables rule which will redirect all DNS requests from processes running
	with the primary group ``gluon-fastd`` to ``127.0.0.1:54``, thus making fastd use the secondary DNS daemon.		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	Original line	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	Original line	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

File added.

Preview size limit exceeded, changes collapsed.

docs/dev/web/model.rst

0 → 100644

+153 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/dev/web/view.rst

0 → 100644

+60 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/features/autoupdater.rst

+83 −17

File changed.

Preview size limit exceeded, changes collapsed.

docs/features/configmode.png

0 → 100644

+112 KiB

111.76 KiB

docs/features/configmode.rst

+19 −2

Original line number	Original line	Diff line number	Diff line
	@@ -14,10 +14,13 @@ Activating Config Mode
	----------------------		----------------------

	Config Mode is automatically entered at the first boot. You can re-enter		Config Mode is automatically entered at the first boot. You can re-enter
	Config Mode by pressing and holding the RESET/WPS button for about three		Config Mode by pressing and holding the RESET/WPS/DECT button for about three
	seconds. The device should reboot (all LEDs will turn of briefly) and		seconds. The device should reboot (all LEDs will turn off briefly) and
	Config Mode will be available.		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		Port Configuration
	------------------		------------------
	@@ -35,3 +38,17 @@ Accessing Config Mode
	Config Mode can be accessed at http://192.168.1.1. The node will offer DHCP		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		to clients. Should this fail, you may assign an IP from 192.168.1.0/24 to
	your computer manually.		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

File added.

Preview size limit exceeded, changes collapsed.

docs/features/fastd_mode.gif

0 → 100644

+28.1 KiB

28.12 KiB

docs/features/monitoring.rst

+11 −10

File changed.

Preview size limit exceeded, changes collapsed.

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/private-wlan.rst

+24 −11

File changed.

Preview size limit exceeded, changes collapsed.

docs/features/roles.rst

+12 −10

File changed.

Preview size limit exceeded, changes collapsed.

docs/features/status-page.png

0 → 100644

+150 KiB

149.70 KiB

docs/features/status-page.rst

0 → 100644

+30 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/features/tls.rst

0 → 100644

+10 −0

Original line number	Original line	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

+102 −34

File changed.

Preview size limit exceeded, changes collapsed.

docs/features/wlan-configuration.rst

+16 −17

File changed.

Preview size limit exceeded, changes collapsed.

docs/index.rst

+73 −229

File changed.

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	Original line	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	Original line	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-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-config-mode-geo-location.rst

deleted100644 → 0

+0 −14

File deleted.

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

+199 −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.rst

+2 −2

File changed.

Preview size limit exceeded, changes collapsed.

docs/releases/v2014.4.rst

+2 −2

File changed.

Preview size limit exceeded, changes collapsed.

docs/releases/v2015.1.2.rst

+1 −1

File changed.

Preview size limit exceeded, changes collapsed.

docs/releases/v2015.1.rst

+18 −18

File changed.

Preview size limit exceeded, changes collapsed.

docs/releases/v2016.1.1.rst

+5 −5

File changed.

Preview size limit exceeded, changes collapsed.

docs/releases/v2016.1.2.rst

+1 −1

File changed.

Preview size limit exceeded, changes collapsed.

docs/releases/v2016.1.3.rst

+1 −1

File changed.

Preview size limit exceeded, changes collapsed.

docs/releases/v2016.1.4.rst

+1 −1

File changed.

Preview size limit exceeded, changes collapsed.

docs/releases/v2016.1.5.rst

+10 −10

File changed.

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

+5 −5

File changed.

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.

docs/releases/v2017.1.4.rst

0 → 100644

+56 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2017.1.5.rst

0 → 100644

+57 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2017.1.6.rst

0 → 100644

+91 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2017.1.7.rst

0 → 100644

+34 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2017.1.8.rst

0 → 100644

+71 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2017.1.rst

0 → 100644

+234 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2018.1.1.rst

0 → 100644

+54 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2018.1.2.rst

0 → 100644

+60 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2018.1.3.rst

0 → 100644

+31 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2018.1.4.rst

0 → 100644

+49 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2018.1.rst

0 → 100644

+421 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2018.2.1.rst

0 → 100644

+132 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2018.2.2.rst

0 → 100644

+69 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2018.2.3.rst

0 → 100644

+89 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2018.2.4.rst

0 → 100644

+53 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2018.2.rst

0 → 100644

+169 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2019.1.1.rst

0 → 100644

+64 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2019.1.2.rst

0 → 100644

+60 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2019.1.3.rst

0 → 100644

+70 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2019.1.rst

0 → 100644

+287 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2020.1.1.rst

0 → 100644

+61 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2020.1.2.rst

0 → 100644

+84 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2020.1.3.rst

0 → 100644

+57 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2020.1.4.rst

0 → 100644

+47 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2020.1.rst

0 → 100644

+240 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2020.2.1.rst

0 → 100644

+47 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2020.2.2.rst

0 → 100644

+42 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2020.2.3.rst

0 → 100644

+49 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2020.2.rst

0 → 100644

+198 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2021.1.1.rst

0 → 100644

+63 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2021.1.2.rst

0 → 100644

+131 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2021.1.rst

0 → 100644

+141 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2022.1.1.rst

0 → 100644

+85 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2022.1.2.rst

0 → 100644

+37 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2022.1.3.rst

0 → 100644

+40 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2022.1.4.rst

0 → 100644

+136 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2022.1.rst

0 → 100644

+417 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2023.1.1.rst

0 → 100644

+62 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2023.1.2.rst

0 → 100644

+58 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2023.1.rst

0 → 100644

+135 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2023.2.1.rst

0 → 100644

+64 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2023.2.2.rst

0 → 100644

+43 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2023.2.3.rst

0 → 100644

+59 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2023.2.4.rst

0 → 100644

+64 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2023.2.5.rst

0 → 100644

+52 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/releases/v2023.2.rst

0 → 100644

+327 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/requirements.txt

0 → 100644

+2 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/site-example/i18n/de.po

+78 −14

File changed.

Preview size limit exceeded, changes collapsed.

docs/site-example/i18n/en.po

+74 −14

File changed.

Preview size limit exceeded, changes collapsed.

docs/site-example/i18n/fr.po

+51 −14

File changed.

Preview size limit exceeded, changes collapsed.

docs/site-example/i18n/gluon-site.pot

+24 −0

File changed.

Preview size limit exceeded, changes collapsed.

docs/site-example/image-customization.lua

0 → 100644

+20 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/site-example/modules

+3 −4

File changed.

Preview size limit exceeded, changes collapsed.

docs/site-example/site.conf

+88 −79

File changed.

Preview size limit exceeded, changes collapsed.

docs/site-example/site.mk

+4 −31

File changed.

Preview size limit exceeded, changes collapsed.

docs/user/faq.rst

+47 −2

File changed.

Preview size limit exceeded, changes collapsed.

docs/user/getting_started.rst

+175 −83

File changed.

Preview size limit exceeded, changes collapsed.

docs/user/mtu-diagram_v5.png

0 → 100644

+67 KiB

File added.

Preview size limit exceeded, changes collapsed.

View file

docs/user/mtu.rst

0 → 100644

+225 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/user/site.rst

+793 −239

File changed.

Preview size limit exceeded, changes collapsed.

docs/user/supported_devices.rst

0 → 100644

+649 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/user/x86.rst

+13 −15

File changed.

Preview size limit exceeded, changes collapsed.

include/config

deleted100644 → 0

+0 −22

File deleted.

Preview size limit exceeded, changes collapsed.

include/gluon.mk

deleted100644 → 0

+0 −82

File deleted.

Preview size limit exceeded, changes collapsed.

include/package.mk

deleted100644 → 0

+0 −35

File deleted.

Preview size limit exceeded, changes collapsed.

include/toplevel.mk

deleted100644 → 0

+0 −62

File deleted.

Preview size limit exceeded, changes collapsed.

include/verbose.mk

deleted100644 → 0

+0 −67

File deleted.

Preview size limit exceeded, changes collapsed.

modules

+12 −14

File changed.

Preview size limit exceeded, changes collapsed.

package/features

0 → 100644

+56 −0

File added.

Preview size limit exceeded, changes collapsed.

package/gluon-alfred/Makefile

+3 −23

File changed.

Preview size limit exceeded, changes collapsed.

package/gluon-alfred/files/lib/gluon/reload.d/301-alfred-stop

0 → 100755

+2 −0

File added.

Preview size limit exceeded, changes collapsed.

package/gluon-alfred/files/lib/gluon/reload.d/799-alfred-start

0 → 100755

+2 −0

File added.

Preview size limit exceeded, changes collapsed.

package/gluon-alfred/files/lib/gluon/upgrade/500-enable-alfred

deleted100755 → 0

+0 −18

File deleted.

Preview size limit exceeded, changes collapsed.

package/gluon-alfred/files/usr/lib/autoupdater/abort.d/60gluon-alfred

+1 −1

File changed.

Preview size limit exceeded, changes collapsed.

package/gluon-alfred/files/usr/lib/autoupdater/download.d/40gluon-alfred

+1 −1

File changed.

Preview size limit exceeded, changes collapsed.

package/gluon-alfred/luasrc/lib/gluon/upgrade/400-alfred-firewall

0 → 100755

+14 −0

File added.

Preview size limit exceeded, changes collapsed.

package/gluon-alfred/luasrc/lib/gluon/upgrade/500-enable-alfred

0 → 100755

+14 −0

File added.

Preview size limit exceeded, changes collapsed.

package/gluon-authorized-keys/Makefile

+3 −27

File changed.

Preview size limit exceeded, changes collapsed.

package/gluon-authorized-keys/check_site.lua

+1 −1

File changed.

Preview size limit exceeded, changes collapsed.

package/gluon-authorized-keys/files/lib/gluon/upgrade/100-authorized-keys→package/gluon-authorized-keys/luasrc/lib/gluon/upgrade/100-authorized-keys

+22 −0

File changed and moved.

Preview size limit exceeded, changes collapsed.

package/gluon-autoupdater/Config.in

0 → 100644

+10 −0

File added.

Preview size limit exceeded, changes collapsed.

package/gluon-autoupdater/Makefile

+14 −25

File changed.

Preview size limit exceeded, changes collapsed.

package/gluon-autoupdater/check_site.lua

+40 −10

File changed.

Preview size limit exceeded, changes collapsed.

package/gluon-autoupdater/files/lib/gluon/autoupdater/lib.sh

+8 −8

File changed.

Preview size limit exceeded, changes collapsed.

package/gluon-autoupdater/files/lib/gluon/upgrade/500-autoupdater

deleted100755 → 0

+0 −56

File deleted.

Preview size limit exceeded, changes collapsed.

package/gluon-autoupdater/files/usr/lib/autoupdater/abort.d/90gluon-autoupdater

+2 −1

File changed.

Preview size limit exceeded, changes collapsed.

package/gluon-autoupdater/files/usr/lib/autoupdater/download.d/10gluon-autoupdater

+2 −1

File changed.

Preview size limit exceeded, changes collapsed.

package/gluon-autoupdater/luasrc/lib/gluon/upgrade/500-autoupdater

0 → 100755

+88 −0

File added.

Preview size limit exceeded, changes collapsed.

package/gluon-autoupdater/src/respondd.c

+5 −25

File changed.

Preview size limit exceeded, changes collapsed.

Source

Target

Files

Some changes are not shown.