diff options
Diffstat (limited to 'doc/install/prokit.mdwn')
-rw-r--r-- | doc/install/prokit.mdwn | 84 |
1 files changed, 53 insertions, 31 deletions
diff --git a/doc/install/prokit.mdwn b/doc/install/prokit.mdwn index 55def93..828075c 100644 --- a/doc/install/prokit.mdwn +++ b/doc/install/prokit.mdwn @@ -8,45 +8,75 @@ 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. -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. + +Dependencies +============ + +Building prokit requires make, a POSIX-conformant shell with `local`, and basic +standard utilities. Git and GNU Autoconf and Automake are currently also +required. + +Running prokit requires the following utilities: + + * A POSIX-conformant shell with `local` and standard utilities + * gunzip + * Either sfdisk or fdisk + * mke2fs + * cpio + * xz from XZ Utils + * mount + * umount + * chroot + +prokit also requires OpenWrt's usign utility to verify archive signatures. A +system copy of usign can be used, however few distributions provide one. An +embedded copy of usign is included, building of which additionally requires: + + * CMake + * A C compiler such as GCC and standard C library headers + +On a Debian-based distribution such as Trisquel, `sudo apt-get install +build-essential cmake` is sufficient. 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 -**sudo**(8) for running commands with superuser privileges. Adjust where -necessary if you don't use **sudo**(8). +The ProteanOS Development Kit uses the **mount**(8) , **umount**(8), and +**chroot**(8) commands, which on Linux require superuser access. This guide +assumes the use of **sudo**(8) for running commands with superuser privileges. +Adjust where necessary if you don't use **sudo**(8). Downloading the ProteanOS Development Kit ========================================= -Download a released version of prokit from the files site by [HTTP][prokit-http] -or [FTP][prokit-ftp], e.g.: +prokit release archives since version 1.1.0 and Git commits since +2.0.1-55-g545e082 are signed with the maintainer's OpenPGP 4096-bit RSA key. +Import the key from a key server (available on the SKS network and on +keys.openpgp.org). Finding a signature path from trusted keys in your keyring +to this key is recommended if possible. $ 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/ -Or clone prokit from the [Git repository][prokit-git]: +The current released version (2.0.1) of prokit lacks features now used by the +ProteanOS package archive. Clone prokit from the [Git repository][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/ +Check for signatures on the recent commits. Either run: + + $ git log --show-signature + +Or configure Git to always show signatures in the log (requires Git 2.10 or +later): + + $ git config log.showSignature true + $ git log + +Either way, look for a `Good signature` made `using RSA key +225031F047FFE51663ED516F1A459ECDE4D604BE` in at least the top-most commits. + [prokit-git]: http://git.proteanos.com/prokit/prokit.git/ @@ -55,17 +85,9 @@ Building the ProteanOS Development Kit Configure and build prokit: - $ ./configure - $ make - -Or, if you cloned the Git repository, run: - $ ./autogen.sh $ make -To build from the repository you'll need to have GNU Autoconf and Automake -installed. - Installing the ProteanOS Development Kit ======================================== |