summaryrefslogtreecommitdiffstats
path: root/README
blob: 4123ef67948b80ca003a59c6fc7cb78b9313f126 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
Mini/Temporary ProteanOS Development Kit
----------------------------------------

This is miniprokit, a small and simple version of the ProteanOS
Development Kit (which is not yet finished).

miniprokit can install a ProteanOS system and run a ProteanOS shell
within an isolated file system environment using the chroot utility.
It is similar in function to the debootstrap program of Debian and
derivatives.

miniprokit can run on any standard GNU or BusyBox system (or probably
any UNIX-like system with GNU Wget and Coreutils installed).  Aside from
standard UNIX utilities, it needs wget, sha256sum, mount, and chroot.

It requires superuser permission to run, as it uses the mount and chroot
utilities.

Installing a ProteanOS system can be done as follows (assuming use of
sudo):

    $ sudo ./miniprokit.sh install root

To cross install another architecture, use the -a option (beware that
only an architecture supported by your CPU can be installed and run),
e.g.:

    $ sudo ./miniprokit.sh install -a i686-linux-glibc root

Platforms can be chosen using the -P option (ProteanOS currently
provides "dev", "ao751h", and "dimension2400"):

    $ sudo ./miniprokit.sh install -P dev root

Start a ProteanOS shell in an isolated file system environment as
follows:

    $ sudo ./miniprokit.sh shell root

Copyright Information
---------------------

Copyright (C) 2014  Patrick "P. J." McDermott

Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.  This file is offered as-is,
without any warranty.