diff options
Diffstat (limited to 'doc/install')
| -rw-r--r-- | doc/install/prokit.mdwn | 51 |
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]]. |