====== Chromium + Capsicum ======

This wiki page describes how to check out and build the experimental extensions to the %%FreeBSD%% [[/Chromium]] port.  Note that this requires installing experimental kernel changes as well as a modified version of Chromium, and is not for the cautious.

===== Install FreeBSD 8.0 =====

Install %%FreeBSD%% 8.0, and the subversion-freebsd port.  While the capabilities8 branch tracks 8-STABLE, the only guaranteed upgrade path is from 8.0, as "downgrades" on 8-STABLE are not guaranteed.

===== Upgrade to capabilities8 =====

Use subversion to check out the capabilities8 branch:

<code>
svn co http://svn.freebsd.org/base/projects/capabilities8 capabilities8
</code>

This will check out a source tree in the capabilities8 directory.  Build world, build kernel with our sample config file CAPABILITIES, install kernel, reboot, mergemaster -p, installworld, reboot.

It is **very** important to reboot before installworld, as base system components in the capabilities8 branch, such as dhclient, gzip, and tcpdump rely on new capability-related system calls to operate.  make installworld will fail nastily if used on a kernel without capabilities support.

===== Check out and build Chromium =====

You will need to install the git port in order to check out our modified version of Chromium.  Our repository includes the %%FreeBSD%% porting changes for the base Chromium components, so the below instructions are a modified version of those found on the [[/Chromium]] wiki page.

First, make sure the icu package is not installed, as it will conflict with the one included with Chromium.

Next, download the patches for third-party components of the Chromium tree:

<code>
fetch http://chromium.jaggeri.com/svndiffs-35870.patch
</code>

Install and configure gclient:

<code>
svn co http://gclient.googlecode.com/svn/trunk/ gclient
python gclient/gclient/gclient.py config http://src.chromium.org/svn/trunk/src
</code>

Check out the chromium-capsicum branch from git:

<code>
git clone git://github.com/rwatson/chromium-capsicum.git src
</code>

We have several branches in our git repo:

  * trunk -- the Chromium baseline we work from, cloned from git.chromium.org
  * chromium-freebsd -- trunk + Ben Laurie and Sprewell's %%FreeBSD%% port patches
  * chromium-capsicum -- chromium-freebsd plus our Capsicum changes

You will want to select chromium-capsicum:

<code>
cd src ; git checkout chromium-capsicum ; cd ..
</code>

Sync the remainder of the tree; gclient should notice that git is being used to manage src and DTRT:

<code>
python gclient/gclient/gclient.py sync --revision src@35870
</code>

All instructions that follow require you to be in the src directory:

<code>
cd src
</code>

Apply the patches for third-party components checked out by gclient:

<code>
patch -p0 < ../svndiffs-35870.patch
</code>

Build Chromium:

<code>
export GYP_GENERATORS make && python build/gyp_chromium -D'OS=freebsd' -D'use_system_libxml=1' build/all.gyp --depth ./
gmake BUILDTYPE=Release chrome
</code>

Mount fdescfs/procfs:

<code>
mount -t procfs procfs /proc
mount -t fdescfs fdescfs /dev/fd
</code>

Run Chromium:

<code>
out/Release/chrome
</code>

You can use procstat to check that some processes in Chromium are running in Capability mode:

<code>
% procstat -as | grep chrome
</code>

Look for processes with the 'C' flag in their credential, which indicates capability mode.