💾 Archived View for 9til.de › fqa › fqa5.gmi captured on 2023-09-08 at 16:03:29. Gemini links have been rewritten to link to archived content

-=-=-=-=-=-=-

FQA INDEX | FQA 4 - 9front Installation Guide | FQA 6 - Networking

FQA 4 - 9front Installation Guide

FQA 6 - Networking

FQA 5 - Building the System from Source

[‡ thesource]

5.1 - Why should I build my system from source?

Some reasons why you might actually wish or need to build from source:

• Updates have been committed since you performed the installation.

• Test or develop new features.

5.2 - Building 9front from source

5.2.1 - Update sources

9front uses hg(1) to synchronize the system with the 9front repository:

hg(1)

9front repository:

cd /

bind -ac /dist/plan9front /

hg incoming

hg -v pull -u

which is consolidated in the command:

sysupdate

If hg refuses to update due to conflicts (e.g. if you installed something locally which was later incorporated into 9front), this is a quick workaround which discards local changes:

hg update -C --clean

After the tree is updated, recompile/build the updated programs as needed.

5.2.1.1 - hgrc

During installation, the 9front Mercurial repository is copied to /dist/plan9front/.hg, is chmod 775, and is owned by user glenda and group sys. To update the repository when logged in as a user other than glenda, add that user to group sys add then add the following to $home/lib/hgrc :

[trusted]

users=glenda

groups=glenda

To use Mercurial with webfs(4) instead of Python’s built-in HTTP:

http://man.9front.org/4/webfs

[extensions]

hgwebfs=

Note: The hgwebfs extension expects login credentials to be present in factotum(4), else Mercurial will abort when any attempt is made to access resources that require authentication. To add credentials to factotum :

http://man.9front.org/4/factotum

echo 'key proto=pass realm=PAIN server=code.9front.org service=http \

user=cinap_lenrek !password=FckG00gl!' >>/mnt/factotum/ctl

Note: Depending on who you are and the repository being used, your credentials may differ.

Credentials may be saved permanently and loaded into factotum at boot time using FQA 8.4.7 - secstore.

fqa8.gmi

5.2.2 - Building from source

Note: A minimum of 512MB RAM is needed to link some programs. If less than 512MB is available, be sure to turn on swap before building (Read: swap(8)).

http://man.9front.org/8/swap

create any missing directories needed for the build

cd /

. /sys/lib/rootstub

build everything

cd /sys/src

mk install

mk clean

build manpage indices

cd /sys/man

build the papers and .html (optional)

cd /sys/doc

mk.html

Note: Before cross compiling a kernel, the compiler, assembler, linker, and paqfs(4) for the target architecture need to be built and installed (Read FQA 5.2.2.1 - Cross compiling).

http://man.9front.org/4/paqfs

fqa8.gmi

Build the kernel for 386:

cd /sys/src/9/pc

mk install

Build the kernel for amd64:

cd /sys/src/9/pc64

mk install

Build the kernel for arm / Raspberry Pi:

cd /sys/src/9/bcm

mk ’CONF=pi’ install

mk ’CONF=pi2’ install

Build the kernel for arm64 / Raspberry Pi 3:

cd /sys/src/9/bcm64

mk install

Read: FQA 7.2.5 - How do I install a new kernel?

fqa7.gmi

5.2.2.1 - Cross compiling

To cross compile, simply set the objtype environment variable prior to running the build. For example, to build all the amd64 binaries on a 386 system:

create any missing directories needed for the build

cd /

. /sys/lib/rootstub

cd /sys/src

objtype=amd64 mk install

5.3 - Building an ISO

The 9front ISO is a livecd that also serves as install media.

Note: Currently, only the 386 architecture is built for the ISO. Read: FQA 8.9 - Bootstrapping architectures not included on the ISO for more information on booting other architectures.

fqa8.gmi