-
Notifications
You must be signed in to change notification settings - Fork 3
/
README
127 lines (104 loc) · 4.82 KB
/
README
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
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
___ ___
_ __ ___ __ _ _ __ _ __ __ _ |_ _|_ _|
| '__/ _ \ / _` | '__|____| '_ \ / _` | | | | |
| | | (_) | (_| | | |_____| | | | (_| | | | | |
|_| \___/ \__,_|_| |_| |_|\__, | |___|___|
|___/
############
# Overview #
############
roar-ng II is a framework for the construction of GNU/Linux distributions. Any
distribution built by:
- Can run "live", without leaving any traces behind.
- Can run from pretty much any media (optical media, flash drives, hard
drives, memory cards and more).
- Is easy to develop, maintain and customize.
roar-ng II provides the means for handling the binary packages of various
distributions; all you have to do in order to build a distribution is to specify
the list of packages to include in it; roar-ng II will take care of the rest.
roar-ng II makes it simple and quick to develop your very own GNU/Linux
distribution. Therefore, it saves your precious time and money.
################
# How it Works #
################
roar-ng II has powerful, extensible design: support for each distribution is
provided by a plug-in. Many distributions are supported, in all processor
architectures.
Thanks to this design, the process of building a distribution is quite simple:
- roar-ng II lists the packages available for each distribution.
- Each package specified in the package list are downloaded from the
repositories of a given distribution.
- All packages are extracted.
- An image of the distribution is built.
In addition, distributions built by roar-ng II ship with an automated package
building framework, which can be used directly through roar-ng II to
cross-compile packages for distributions built by it.
###########################
# Supported Distributions #
###########################
Distributions currently supported by roar-ng II are:
- Debian (http://www.debian.org/) and derivatives:
- Ubuntu (http://www.ubuntu.com/)
- Linux Mint (http://www.linuxmint.com/)
- Trisquel GNU/Linux (http://www.trisquel.info/)
- Raspbian (http://www.raspbian.org/)
- RPM-based distributions:
- Mageia (http://www.mageia.org/)
- Fedora (http://fedoraproject.org/)
- CentOS (https://www.centos.org/)
- openSUSE (http://www.opensuse.org/)
- Arch Linux (http://www.archlinux.org/) and derivatives:
- Parabola GNU/Linux (https://www.parabolagnulinux.org/)
- ConnochaetOS (http://www.connochaetos.org/)
- Slackware (http://www.slackware.com/) and derivatives:
- Salix OS (http://www.salixos.org)
- Puppy Linux (http://www.puppylinux.org/) and derivatives:
- Slacko
- Precise Puppy
- Wary (http://www.bkhome.org/wary/)
This means roar-ng II is able to build distributions using packages which
originate in any version of these distributions, for any processor architecture.
#########
# Usage #
#########
A typical roar-ng II session consists of four steps:
- roar-ng setup : downloads and processes the package lists of all
repositories of distributions specified in the package
list.
- roar-ng download: downloads all packages specified in the package list.
- roar-ng extract : extracts the downloaded packages.
- roar-ng build : builds a bootable image of the distribution; receives two
additional command-line arguments: the bootable media type
and the output file path.
In addition, roar-ng II exposes some functionality through additional execution
modes:
- package : builds a binary package from source, within the distribution;
must run after "build". In this mode, roar-ng II needs sufficient
permissions to run mount and chroot.
- cleanup : cleans up after "build" by removing intermediate directories.
Must be used between executions of roar-ng II with "build".
##########
# Shahor #
##########
Shahor is the flagship GNU/Linux-libre distribution built by roar-ng II; the
stock configuration supplied with roar-ng II will always build the latest
development version of Shahor.
To build Shahor, simply run roar-ng II:
roar-ng setup
roar-ng download
roar-ng extract
roar-ng build isolinux shahor.iso
################
# Contributing #
################
Contributions to roar-ng II are welcome, as long as they match its coding style
and design philosophy.
Although roar-ng II will always be free software, bear in mind that by
contributing, you agree that the contributed material may be re-licensed without
notice.
#####################
# Legal Information #
#####################
roar-ng II is licensed under a 2-clause BSD license, see COPYING for the license
text. For a list of its authors and contributors, see AUTHORS and THANKS.
The ASCII art logo at the top was made using FIGlet (http://www.figlet.org/).