aboutsummaryrefslogtreecommitdiff
path: root/README
blob: 72c800e622c28f7c70e12e3375a78a5bb16b1b73 (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
49
50
51
carbs rootfs script
-------------------

Tool for generating rootfs tarballs for Carbs Linux. But
it can be configured to create tarballs for KISS, create
a personalized pre-configured tarball with an Xorg server
to ease installation process. Tarballs on
https://dl.carbslinux.org are generated from this script.


configuration
-------------

Configuration can be done by copying config.def file to
config. There you can configure where the rootfs will be
created, packages to be installed, CFLAGS, MAKEFLAGS,
repository to be added, and the `KISS_PATH` to be used.


extra repositories
------------------

The script by default only installs a single repository,
but can accept a file named 'repositories' to add additional
repositories to the target system. This file is structured
in a plaintext manner and has 3 seperate sections.

1. Git URL
2. Target location
3. Git clone options (such as --depth 1)

Here is an example repositories file. The local repository is
for example purposes, don't actually use local repositories.


    https://git.u.com/repo1 /var/db/kiss/personalrepo --depth 1
    /home/user/kiss-repo2   /var/db/kiss/kiss-repo2   --no-local --depth 2


You can then add these to your KISS_PATH by editing the
config file and adding the following to your `HOST_REPO_PATH`.


    HOST_REPO_PATH="/tmp/repo/core:$MNTDIR/var/db/kiss/personalrepo:$MNTDIR/var/db/kiss/kiss-repo2"


postinstall
-----------

You can change the postinstall (which defaults to true) function to
make manual changes to the generated root filesystem.