summaryrefslogtreecommitdiffstats
path: root/doc/install/prokit.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'doc/install/prokit.mdwn')
-rw-r--r--doc/install/prokit.mdwn51
1 files changed, 32 insertions, 19 deletions
diff --git a/doc/install/prokit.mdwn b/doc/install/prokit.mdwn
index 3e32017..55def93 100644
--- a/doc/install/prokit.mdwn
+++ b/doc/install/prokit.mdwn
@@ -8,10 +8,17 @@ to install a ProteanOS system, run a ProteanOS shell and other commands, manage
software packages on an installed ProteanOS system, and build packages for
ProteanOS.
-Building and installing prokit is easy. Ensure you have a **make**(1) utility
-such as GNU Make installed. No C or C++ compiler or other development tools are
-necessary to build prokit. To install and manage ProteanOS systems you need a
-host system running Linux 3.4 or later.
+prokit requires gunzip, either sfdisk or fdisk, mke2fs, cpio, and xz from XZ
+Utils; the `configure` script should find these automatically if installed.
+prokit also requires OpenWrt's usign utility to verify archive signatures. An
+embedded copy of usign is included, building of which additionally requires
+CMake, a **make**(1) utility such as GNU Make, a C compiler such as GCC, and
+standard C library headers (`sudo apt-get install build-essential cmake` is
+sufficient on a Debian-based distribution such as Trisquel); or a system copy of
+usign can be used instead.
+
+To install and manage ProteanOS systems you need a host system running Linux 3.4
+or later.
The ProteanOS Development Kit uses the **chroot**(8) and **mount**(8) commands,
which on Linux require superuser access. This guide assumes the use of
@@ -22,26 +29,25 @@ necessary if you don't use **sudo**(8).
Downloading the ProteanOS Development Kit
=========================================
-Clone prokit from the [Git repository][prokit-git]:
+Download a released version of prokit from the files site by [HTTP][prokit-http]
+or [FTP][prokit-ftp], e.g.:
- $ git clone git://git.proteanos.com/prokit/prokit.git
- $ cd prokit/
-
-*(Using the current released version, 1.1.0, is not recommended at this time, as
-the Git repository contains numerous major [improvements][prokit-news] including
-use of an updated mirrors list and installer commands for PC block devices and
-initramfs images. The head of the Git master branch is stable, with no known
-bugs. Version 2.0.0 will be released soon, pending some additional new
-features.)*
+ $ gpg --recv-keys 0x225031F047FFE51663ED516F1A459ECDE4D604BE
+ $ # Find a signature path from your keyring to 0x1A459ECDE4D604BE
+ $ wget http://files.proteanos.com/pub/prokit/2.0.0/prokit-2.0.0.tar.gz \
+ > http://files.proteanos.com/pub/prokit/2.0.0/prokit-2.0.0.tar.gz.asc
+ $ gpg --verify prokit-2.0.0.tar.gz.asc prokit-2.0.0.tar.gz
+ $ tar -xzf prokit-2.0.0.tar.gz
+ $ cd prokit-2.0.0/
-Users of Parabola GNU/Linux-libre and Arch [GNU/]Linux can find prokit packages
-in the AUR (thanks to Serge Victor):
+Or clone prokit from the [Git repository][prokit-git]:
- * [prokit-git][aur-prokit-git]
+ $ git clone git://git.proteanos.com/prokit/prokit.git
+ $ cd prokit/
+[prokit-http]: http://files.proteanos.com/pub/prokit/
+[prokit-ftp]: ftp://files.proteanos.com/pub/prokit/
[prokit-git]: http://git.proteanos.com/prokit/prokit.git/
-[prokit-news]: http://git.proteanos.com/prokit/prokit.git/tree/NEWS/
-[aur-prokit-git]: https://aur.archlinux.org/packages/prokit-git/
Building the ProteanOS Development Kit
@@ -49,6 +55,11 @@ Building the ProteanOS Development Kit
Configure and build prokit:
+ $ ./configure
+ $ make
+
+Or, if you cloned the Git repository, run:
+
$ ./autogen.sh
$ make
@@ -78,3 +89,5 @@ prokit comes with a manual, starting with the **prokit**(1) page:
Or, if you didn't install prokit, you can find the manual by running:
$ man man/prokit.1
+
+The manual is also available from the [[prokit_homepage|dev/prokit]].