aboutsummaryrefslogtreecommitdiff
path: root/contrib
diff options
context:
space:
mode:
authorng0 <ng0@n0.is>2018-01-04 16:45:11 +0000
committerng0 <ng0@n0.is>2018-01-04 16:45:11 +0000
commitacd48a8676a945f491f4e62c9f17e2ff0d688d56 (patch)
tree6d0b1863d2b21c85950cc7da3ff11d741211ddba /contrib
parente9c8850dd6324241c4e1567289b617be44bda1d3 (diff)
downloadgnunet-acd48a8676a945f491f4e62c9f17e2ff0d688d56.tar.gz
gnunet-acd48a8676a945f491f4e62c9f17e2ff0d688d56.zip
extend contrib packages guix README
Diffstat (limited to 'contrib')
-rw-r--r--contrib/packages/guix/README47
1 files changed, 36 insertions, 11 deletions
diff --git a/contrib/packages/guix/README b/contrib/packages/guix/README
index 0b66e500a..9062cdb68 100644
--- a/contrib/packages/guix/README
+++ b/contrib/packages/guix/README
@@ -1,39 +1,64 @@
1package definitions for GNU Guix 1package definitions for GNU Guix
2--------------------------------- 2---------------------------------
3 3
4About
5-----
6
7This directory contains various files to work with GNUnet using Guix:
8
9* A folder intended to be used with GUIX_PACKAGE_PATH ("packages")
10* gnunet-doc.scm: A file to ease the building of the docgen script output
11* gnunet.scm: A file to build gnunet with all tests
12* guix-env.scm
13
14The workflow has to be documented and will make its way into the GNUnet
15Documentation eventually. For now, all uses of guix environment, guix package,
16etc apply.
17Example invocation:
18 guix environment --ad-hoc --container --network --fallback -K -l contrib/packages/guix/gnunet.scm
19which is worth improving, but essentially takes you into an container environment
20with gnunet from HEAD, under the condition that it builds. This won't include an editor,
21so you want to run
22 guix environment --ad-hoc emacs --container --network --fallback -K -l contrib/packages/guix/gnunet.scm
23(untested). You get the idea that this folder is a historical mess and should be cleaned up
24and properly documented.
25
4Usage 26Usage
5----- 27-----
6 28
7Just point Guix towards the root of this source tree: 29Just point Guix towards the root of this source tree.
30Assuming that your gnunet checkout is in $HOME/src/gnunet:
31
32 export GUIX_PACKAGE_PATH=$HOME/src/gnunet/contrib/packages/guix/packages
8 33
9export GUIX_PACKAGE_PATH=/path/to/packages
10or (if you are in the root of the gnunet git repository): 34or (if you are in the root of the gnunet git repository):
11guix package -L contrib/packages/guix/packages -i package-name 35
36 guix package -L contrib/packages/guix/packages -i package-name
12 37
13The packages in this repository will take precedence over those in the 38The packages in this repository will take precedence over those in the
14official distribution. 39official distribution.
15 40
41
16To make use of the packages in your GuixSD config file: 42To make use of the packages in your GuixSD config file:
17 43
18Be sure to have GUIX_PACKAGE_PATH for your shell exported, 44Be sure to have GUIX_PACKAGE_PATH for your shell exported,
19for bash this could be achieved like this: 45for Bash this could be achieved like this:
20 46
21export GUIX_PACKAGE_PATH="/full/path/to/gnunet/contrib/packages/guix/directory" 47 export GUIX_PACKAGE_PATH="/full/path/to/gnunet/contrib/packages/guix/directory"
22 48
23In the section of your systems "config.scm", you should find 49In the section of your systems "config.scm", you should find something like this:
24something like this:
25 50
26(use-modules (gnu) (gnu system nss)) 51 (use-modules (gnu) (gnu system nss))
27 52
28Now to make use of "gnunetg" as an systemwide installed package we change this 53Now to make use of "gnunetg" as an systemwide installed package we change this
29to: 54to:
30 55
31(use-modules (gnu) (gnu system nss) 56 (use-modules (gnu) (gnu system nss)
32 (gnunet packages gnunet)) 57 (gnunet packages gnunet))
33 58
34and do the usual thing: 59and do the usual thing:
35 - save 60 - save
36 - guix system build /etc/config.scm 61 - guix system build /etc/config.scm
37 - sudo -E guix system reconfigure /etc/config.scm 62 - sudo -E guix system reconfigure /etc/config.scm
38 63
39The "-E" in "sudo -E" is important! 64The "-E" in "sudo -E" is important to keep the environment variables (GUIX_PACKAGE_PATH). \ No newline at end of file