Pedigree operating system
C C++ Python Shell Objective-C Assembly Other
Latest commit 4f02647 May 25, 2013 @miselin miselin misc: updated README
Permalink
Failed to load latest commit information.
build-etc build: ignore .tags, SublimeClang config in the project file Apr 22, 2013
compilers compilers: link with a dynamic linker (/libraries/libload.so, doesn't… Feb 2, 2013
docs Pretend you didn't see this. Just more USB stuff Apr 15, 2010
images greeting: updated greeting message May 25, 2013
scripts
src native: don't time native syscalls anymore May 25, 2013
templates Added kdevelop templates folder Jan 28, 2008
tests
.gitignore build: ignore .tags, SublimeClang config in the project file Apr 22, 2013
.gitmodules
CONTRIB
Doxyfile Add all three subsystems to the Doxyfile Aug 18, 2010
LICENSE
README misc: updated README May 25, 2013
SConscript build: make FAT build the default, as I'm not sure what state ext2 is… May 25, 2013
SConstruct build: make FAT build the default, as I'm not sure what state ext2 is… May 25, 2013
easy_build_arm.sh
easy_build_x64.sh build: easy build updated to reflect the fact that bash relies on lib… Mar 12, 2013
easy_build_x86.sh build: x86 easy build now installs cairo and friends May 2, 2013
run_pup.py
setup_pup.py

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