OpenWrt Hacking - Chaos Computer ClubOpenWrt Hacking Felix Fietkau December 27, 2005 elixF Fietkau...

IntroductionBuilding packages and images

Structure of the Buildroot

OpenWrt Hacking

Felix Fietkau

December 27, 2005

Felix Fietkau OpenWrt Hacking

OverviewWhat is OpenWrt?New features

Overview

1 Introduction

Overview

What is OpenWrt?

New features

2 Building packages and images

Software Development Kit

Image Builder

Package directories

The package Make�le

3 Structure of the Buildroot

Buildroot directories

The toolchain/ directory

The package/ directory

The target/ directory

Overview

1 Introduction

Overview

What is OpenWrt?

New features

Image Builder

Package directories

Overview

1 Introduction

Overview

What is OpenWrt?

New features

Image Builder

Package directories

Introduction to OpenWrt

Linux distribution for embedded wireless routers

Runs on inexpensive hardware

Free Software under the GNU GPL

Stable version:

Linux 2.4Single platform: BCM947xx (or BCM953xx)

Development version:

Linux 2.4 and Linux 2.6 (depending on target platform)Texas Instruments AR7Embedded X86 (Soekris, WRAP, etc.)Atheros AR531x/231x (planned)RouterBoard 5xx (planned)

Stable version:

Linux 2.4

Single platform: BCM947xx (or BCM953xx)

Stable version:

Linux 2.4 and Linux 2.6 (depending on target platform)

Texas Instruments AR7Embedded X86 (Soekris, WRAP, etc.)Atheros AR531x/231x (planned)RouterBoard 5xx (planned)

Stable version:

Linux 2.4 and Linux 2.6 (depending on target platform)Texas Instruments AR7

Embedded X86 (Soekris, WRAP, etc.)Atheros AR531x/231x (planned)RouterBoard 5xx (planned)

Stable version:

Linux 2.4 and Linux 2.6 (depending on target platform)Texas Instruments AR7Embedded X86 (Soekris, WRAP, etc.)

Atheros AR531x/231x (planned)RouterBoard 5xx (planned)

Stable version:

Linux 2.4 and Linux 2.6 (depending on target platform)Texas Instruments AR7Embedded X86 (Soekris, WRAP, etc.)Atheros AR531x/231x (planned)

RouterBoard 5xx (planned)

Stable version:

New Features

Version 1.0, codename: 'White Russian'

Lots of bug �xesA web interfaceScripts for handling system eventsBetter performance and faster boot time

Version 2.0, codename: 'Kamikaze'

New platformsNetwork scripts rewriteMultiple SSIDs for the Broadcom platform

New Features

Lots of bug �xes

A web interfaceScripts for handling system eventsBetter performance and faster boot time

New Features

Lots of bug �xesA web interface

Scripts for handling system eventsBetter performance and faster boot time

New Features

Lots of bug �xesA web interfaceScripts for handling system events

Better performance and faster boot time

New Features

New platforms

Network scripts rewriteMultiple SSIDs for the Broadcom platform

New Features

New platformsNetwork scripts rewrite

Multiple SSIDs for the Broadcom platform

New Features

Software Development KitImage BuilderPackage directoriesThe package Make�le

Building packages and images

Generated from the Buildroot

Compiles packages

Uses buildroot-compatible package directories

Contains precompiled versions of the toolchain and all libraries

Using the SDK:

Copy the package directory in package/(optional) add dependencies in package/depend.mkrun make

Compiles packages

Using the SDK:

Compiles packages

Using the SDK:

Compiles packages

Using the SDK:

Compiles packages

Using the SDK:

Compiles packages

Using the SDK:

Copy the package directory in package/

(optional) add dependencies in package/depend.mkrun make

Compiles packages

Using the SDK:

Copy the package directory in package/(optional) add dependencies in package/depend.mk

run make

Compiles packages

Using the SDK:

Image Builder

Builds images from package lists

Contains all binary packages and image building software

Using the Image Builder:

(optional) Add extra packages to packages/

(optional) Add extra �les to files/

(optional) Modify/add package lists in lists/run make

Image Builder

(optional) Modify/add package lists in lists/

run make

Image Builder

Anatomy of a package directory

./Config.in

Menucon�g con�guration items for the package

./Makefile

Main make�le containing all build instructions

./ipkg/

ipkg control �les and scripts

./patches/

Contains patches for the package

./files/

Extra �les for the package or the package build

./Config.in

./Makefile

./ipkg/

./patches/

./files/

./Config.in

./Makefile

./ipkg/

./patches/

./files/

./Config.in

./Makefile

./ipkg/

./patches/

./files/

./Config.in

./Makefile

./ipkg/

./patches/

./files/

The package menucon�g �le

Syntax: Linux 2.6 menucon�g

Example:

config BR2_PACKAGE_WEBIF

select BR2_PACKAGE_HASERL

tristate "webif - OpenWrt Administrative Console"

default y

A web interface for configuring OpenWrt

The package menucon�g �le

Syntax: Linux 2.6 menucon�g

Example:

config BR2_PACKAGE_WEBIF

select BR2_PACKAGE_HASERL

tristate "webif - OpenWrt Administrative Console"

default y

A web interface for configuring OpenWrt

1. Header:

include $(TOPDIR)/rules.mk

PKG_NAME:=strace

PKG_VERSION:=4.5.11

PKG_RELEASE:=1

PKG_MD5SUM:=28335e15c83456a3db055a0a0efcb4fe

PKG_SOURCE_URL:=@SF/strace

PKG_SOURCE:=$(PKG_NAME)-$(PKG_VERSION).tar.bz2

PKG_CAT:=bzcat

PKG_BUILD_DIR:=$(BUILD_DIR)/$(PKG_NAME)-$(PKG_VERSION)

include $(TOPDIR)/package/rules.mk

1. Header:

include $(TOPDIR)/rules.mk

PKG_NAME:=strace

PKG_VERSION:=4.5.11

PKG_RELEASE:=1

PKG_MD5SUM:=28335e15c83456a3db055a0a0efcb4fe

PKG_SOURCE_URL:=@SF/strace

PKG_SOURCE:=$(PKG_NAME)-$(PKG_VERSION).tar.bz2

PKG_CAT:=bzcat

PKG_BUILD_DIR:=$(BUILD_DIR)/$(PKG_NAME)-$(PKG_VERSION)

include $(TOPDIR)/package/rules.mk

2. Package declaration:

$(eval $(call PKG_template,STRACE,strace,\

$(PKG_VERSION)-$(PKG_RELEASE),$(ARCH)))

3. Important build targets:

$(PKG_BUILD_DIR)/.configured:

# run the package ./configure script

touch $@

$(PKG_BUILD_DIR)/.built:

# run the package makefile

touch $@

4. Package targets:

$(IPKG_STRACE):

# copy all files into $(IDIR_STRACE)

$(IPKG_BUILD) $(IDIR_STRACE) $(PACKAGE_DIR)

5. Extra targets:

mostlyclean:

# run make clean in the package directory

4. Package targets:

$(IPKG_STRACE):

5. Extra targets:

mostlyclean:

4. Package targets:

$(IPKG_STRACE):

5. Extra targets:

mostlyclean:

4. Package targets:

$(IPKG_STRACE):

5. Extra targets:

mostlyclean:

5. Extra targets:

compile-targets: install-dev

clean-targets: uninstall-dev

install-dev:

# run make install and install development

# headers/libraries into $(STAGING_DIR)

uninstall-dev:

# remove all development files of this

# package from $(STAGING_DIR)

Buildroot directoriesThe toolchain/ directoryThe package/ directoryThe target/ directory

Source directories

toolchain/

package/

target/

scripts/

Build directories

toolchain_build_<arch> /

staging_dir_<arch> /

build_<arch> /

Source directories

toolchain/

package/

target/

scripts/

Build directories

build_<arch> /

Source directories

toolchain/

package/

target/

scripts/

Build directories

build_<arch> /

Source directories

toolchain/

package/

target/

scripts/

Build directories

build_<arch> /

Source directories

toolchain/

package/

target/

scripts/

Build directories

build_<arch> /

Source directories

toolchain/

package/

target/

scripts/

Build directories

build_<arch> /

Source directories

toolchain/

package/

target/

scripts/

Build directories

build_<arch> /

Source directories

toolchain/

package/

target/

scripts/

Build directories

build_<arch> /

Source directories

toolchain/

package/

target/

scripts/

Build directories

build_<arch> /

unpacks kernel headers

builds binutils

builds initial gcc

uses initial gcc to build uClibc

builds �nal gcc

(optional) builds binutils

builds binutils

builds initial gcc

builds �nal gcc

builds binutils

builds initial gcc

builds �nal gcc

builds binutils

builds initial gcc

builds �nal gcc

builds binutils

builds initial gcc

builds �nal gcc

builds binutils

builds initial gcc

builds �nal gcc

Build directories for all packages

Exception: kernel-modules and kernel-speci�c packages

Makefile

handles package dependencies

Config.in

includes all package menucon�g �les

Makefile

Config.in

Makefile

Config.in

Makefile

Config.in

linux/linux-<2.4|2.6>

Compiles/installs the kernelCalls target/linux/package/

linux/package/

Similar to the main package/ directoryBuilds kernel-speci�c packages (e.g. modules)

linux/image/

Builds �rmware imagesSubdirectories for �lesystems and system types

Compiles/installs the kernel

Calls target/linux/package/

linux/package/

linux/image/

linux/package/

linux/image/

linux/package/

linux/image/

linux/package/

Similar to the main package/ directory

Builds kernel-speci�c packages (e.g. modules)

linux/image/

linux/package/

linux/image/

linux/package/

linux/image/

linux/package/

linux/image/

Builds �rmware images

Subdirectories for �lesystems and system types

linux/package/

linux/image/

OpenWrt Hacking - Chaos Computer ClubOpenWrt Hacking Felix Fietkau December 27, 2005 elixF Fietkau...

Documents

Ethical Hacking: Hacking GMail. Teaching Hacking

2M 4 BANKS 16 BITS SDRAM - OpenWrt

Do you really need to fork OpenWRT? - WordPress.comDo you really need to fork OpenWRT? Sharing our experience with OpenWISP Firmware. Introducing myself Federico Capoano Developer

NETSHe for OpenWRT - Ubiquiti Networksdl.ubnt.com/RouterStationChallenge/NETSHe/NETSHe_eng.pdfThis software is a custom image of OpenWRT (kamikaze) with Linux 2.6 kernel. Therefore,

PowerPC 405EP Embedded Processor Data Sheet - OpenWrt Wiki

Router OpenWrt Linux Webcam Interface

OpenWRT on the Belkin F5D7230-4 - Serial Console

Optimizing Development for OpenWrt Using Paper... · 2020-03-13 · The OpenWrt package repository is an invaluable resource that currently contains over 3500 packages1. As OpenWrt

Modding, Security, & Privacy (OpenWRT edition) · Why OpenWrt? One of several firmware choices since public WRT54G code – along with DD-WRT and Tomato Full packaging system for

MetaROUTER and OpenWrt - MUM - MikroTik User …mum.mikrotik.com/presentations/CN12/jesse.pdfMetaROUTER and OpenWrt Jesse Liu Convergingstream AboutMe& • JesseLiu,Convergingstream

OpenWRT manual

OpenWrt Bridge

C. Rödel, H. Becker, R. Fietkau , U. Graeven ,

OpenWRT guide and memo

HaEpUz: OpenWRT · OpenWrt 0.9 White Russian 2551 3493 5456 6257 8496 12777 Openwrt 8.09 Kamikaze 13109 14126 14510 16278 18801 OpenWrt 10.03 Backfire 20728 29592 33081 33625 OpenWrt

Installing OpenWRT on a Raspberry Pi as

Rapid Board Support Package prototyping with OpenWrt · Florian Fainelli Rapid Board Support Package prototyping with OpenWrt. Introduction Design Working with the environment Example

Openwrt docs DocumentationOpenwrt docs Documentation, Release The LEDE Project (“Linux Embedded Development Environment”) is a Linux operating system based on OpenWrt. It is a

OpenWrt101:HowtoBuildaLinux EmbeddedSysteminJust30Minutes · ComparativeTable-OpenWrt,Buildroot,Yocto Component OpenWrt Buildroot Yocto Menuconfig Kconfig Kconfig Kconfig Clibraries

Openwrt docs Documentation