Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Pedigree operating system
C C++ Python Shell Objective-C Assembly Other
Failed to load latest commit information.
build-etc build: ignore .tags, SublimeClang config in the project file
compilers compilers: link with a dynamic linker (/libraries/libload.so, doesn't…
docs Pretend you didn't see this. Just more USB stuff
images greeting: updated greeting message
scripts scripts: updated my bochsrc
src native: don't time native syscalls anymore
templates Added kdevelop templates folder
tests Added a dynamic linker - the ability to use ELF shared libraries. Bas…
.gitignore build: ignore .tags, SublimeClang config in the project file
.gitmodules Added the CDI repository as a submodule. It's currently not integrate…
CONTRIB Updated the CONTRIB file.
Doxyfile Add all three subsystems to the Doxyfile
LICENSE Add a LICENSE file
README misc: updated README
SConscript build: make FAT build the default, as I'm not sure what state ext2 is…
SConstruct build: make FAT build the default, as I'm not sure what state ext2 is…
easy_build_arm.sh ARM: easy build script, and a variety of build fixes. DOES NOT LINK i…
easy_build_x64.sh build: easy build updated to reflect the fact that bash relies on lib…
easy_build_x86.sh build: x86 easy build now installs cairo and friends
run_pup.py build: added pup to the tree.
setup_pup.py build: added pup to the tree.

README

BUILD README
=======================

We highly recommend you first try one of our Easy Build scripts before you try
and run SCons manually. There's a little bit of work involved in setting up a
build of Pedigree for the first time - after that it's as easy as just running
"scons" at the command line.

Just run ./easy_build_x86.sh, ./easy_build_x64.sh, or ./easy_build_arm.sh to
build Pedigree for the relevant architecture. Dependencies and a cross-compiler
will be installed/created, allowing you to jump straight into testing Pedigree.

To build Pedigree at any point after this, just run "scons".

To switch between architectures, just remove "options.cache" before you re-run
an easy build script.

Alternatively, you can build manually if you already have a cross-compiler:

Required: SCons 1.2.0

Simply run:

scons CROSS=/path/to/compilers/bin/i686-pedigree-

You should give SCons the path to gcc in CROSS, ending in '-' so it can add
'gcc', 'g++' or 'as' to the end of the stub and get a valid compiler. It'll
work out from the compiler chosen what default options and what architecture
to compile.

Run "scons -h" to obtain a full set of arguments you can pass to configure
the build.

NOTE: This must be a full path. It cannot contain bash expansions such as
environment variables or '~'.

IMAGES DIRECTORY
=======================

The images/local directory allows you to use Pup, Pedigree's package manager,
to manage your hard disk image file set. If you ran the Easy Build script, pup
is already configured and ready to go.

Simply run:
    ./run_pup.py sync
to synchronise your local pup repository with the server.

Then you can run:
    ./run_pup.py install <package>
to install a package.

If you visit http://pup.pedigree-project.org/pup you can see a list of all
packages that are available and can be downloaded.

Remember to re-run SCons after installing a package to ensure your disk image
has the new package on it. You may need to 'rm build/hdd.img' if SCons doesn't
detect that the images directory has changed.

You can also add arbitrary files to the images/local directory to use them at
runtime. For example, you might create a directory under 'users' for yourself,
and add a .bashrc and .vimrc.

USERS
=======================

A utility script 'scripts/manage_users.py' is provided to add or remove users
from the database for use at runtime.

ISSUES
=======================

Report any issues on the project tracker at http://pedigree-project.org
Something went wrong with that request. Please try again.