Context Navigation

Version 15 (modified by rick, 15 years ago) ( diff )
--

Welcome to NanoBSD, FreeBSD default method for installing FreeBSD on embedded devices, like Soekris and others. The manual described below is (loosely) based on the Concept plan of Tim Baas, but also consists of many hints by official 'Introduction to NanoBSD' manual

Have to remember links

Procedure

Please note to find the supporting files in the subdirectory nanobsd

Build environment

Get yourself a fresh freebsd host with ports and subversion installed

Run the basic CD installer of 7.x. Manual tested with 7.1-RELEASE (real basic install will fit our needs). Installing FreeBSD is not scope of the document, take a look into the FreeBSD handbook Chapter 2 Installing FreeBSD if you do not know the details.
get latest sources csup -g -L 2 -h cvsup.nl.freebsd.org /usr/share/examples/cvsup/standard-supfile
install subversion pkg_add -r subversion
fetch ports portsnap fetch extract
OPTIONAL, every developer has his own preferences, these are mine ;-) pkg_add -r vim-lite sudo screen

Introduction

First download the environment and run initial build

$ setenv R /root/nanobsd
$ svn checkout http://svn.wirelessleiden.nl/svn/projects/iris/nanobsd $R
$ cd $R
$ sh /usr/src/tools/tools/nanobsd/nanobsd.sh -c $R/cfg/nanobsd.wleiden

Even the little script got flags, check the output of sh /usr/src/tools/tools/nanobsd/nanobsd.sh -h

-b suppress builds (both kernel and world)
-k suppress buildkernel
-w suppress buildworld
-c specify config file

XXX: TODO describe procedure

WL specific

stumber, hidden gem maybe /usr/src/tools/tools/net80211/stumber

Hints

You could always decide to install your FreeBSD base instance into a virtual envirionment
cvsup.nl.freebsd.org is the local dutch cvsup mirror, replace nl with your proper country code
It seems tempting to follow /usr/share/examples/cvsup/stable-supfile instead of /usr/share/examples/cvsup/standard-supfile please DO NOT unless your like big trouble as stable-supfile is the stable DEVELOPMENT branch e.g. upcoming stable.