seb view README @ rev 10

Some tiny fixes + add ncdu package
author Christophe Lincoln <pankso@slitaz.org>
date Mon Mar 06 18:37:02 2017 +0100 (2017-03-06)
parents 30b4a41d932d
children d28b86ae0e45
line source
1 SEB - SliTaz Embedded OS
2 ================================================================================
4 Back to the root with this cmdline tool to build realy small SliTaz textmode
5 system for hacking, learning and developing small Linux operating system.
7 Seb builder will init a minimal set of files that you can customise at your
8 needs, install Busybox and create a compressed rootfs that can boot in frugal
9 mode as well as an ISO image to use with Qemu. Other boot methods can be used
10 with a bit a knowledge (web boot). The system is built in a single rootfs
11 folder wich can be used as chroot environment.
13 SliTaz embedded provide all basic Linux command, a powerfull web server with
14 CGI support and a set of home made tools for administration and debuging. Seb
15 is easy too use, follow the KISS principle. Please use SliTaz Bugs System
16 for any bug report. There is no wifi support and it's not bug :-)
18 If you want to learn more about the basics of a Linux operating system you
19 can have a look to SliTaz Scratchbook wich explain step by step the creation of
20 SliTaz back in 2006. This tool was published in 2017, ten years after the first
21 cooking public release :-)
23 Seb system will fit into a ~4MB ISO image for the realy base system, up to 10Mb
24 or more, but without X. If you are seraching for an even more small SliTaz
25 version, please have a look to Tiny SliTaz: http://tiny.slitaz.org
28 Goals and features
29 -------------------------------------------------------------------------------
31 * Built fast and light servers or mediabox
32 * Nice way to learn about creating Linux OS
33 * Built small rescue systems in frugal mode
34 * Fun playground for hackers and kids
37 Quickstart Guide:
38 --------------------------------------------------------------------------------
39 Build a distro in a few commands. Install seb or run it from source tree. After the
40 init command you can modify and add extra files in the embfs/ folder:
42 # mkdir my-seb; cd my-seb
43 # seb init
44 # seb -p sqlite --add
45 # seb build
48 Build process & environment
49 --------------------------------------------------------------------------------
50 Seb is not compliling any tools, it will use SliTaz standard executable and
51 libraries - Seb OS is created on top of SliTaz. Packages installed in seb must
52 be on the build host, this is the case for the full basic sysem.
54 Seb will build the custom operating system into the current directory or it
55 will read a build.conf file to know the path to the work/build folder. Seb will
56 use these directories to work:
58 * rootfs/ The root filsysytem of the compressed operationg system
59 * rootiso/ Root of the ISO image with rootfs.gz, bootloader and kernel
60 * sebfs/ Custom files overwritting file into the rootfs
61 * sebpkgs/ The packages to install into the distro
64 Frugal install
65 --------------------------------------------------------------------------------
66 A frugal installation let you boot your seb system without any installation and
67 with the all system running in memory. Basicaly you need to have the rootfs.gz
68 and the kernel in the /boot tree and a entry in Grub configuration file. SliTaz
69 provide a nifty little tools for frugal install:
71 # frugal path/to/image.iso
73 Grub entry will need a rdinit=/sbin/init on the kernel line. Here is an example:
75 # Seb OS Frugal on sdb1
76 title SliTaz Embedded OS (frugal)
77 root (hd0,0)
78 kernel /boot/frugal/bzImage root=/dev/null rdinit=/sbin/init
79 initrd /boot/frugal/rootfs.gz
82 Virtual disk
83 --------------------------------------------------------------------------------
84 A virtual disk let you have a persitstant filesystem when using Qemu or booting,
85 in frugal mode (recommended). It is useful when developping/debugging scripts
86 that runs into a seb-os or to host web server virtual hosts. Create, mount or
87 umount disk:
89 # seb disk
92 Source code and devel guidelines
93 --------------------------------------------------------------------------------
94 Note even need to say that this tool MUST stay simple, fast, elegant and fun.
95 We dont want a super tool for complex system building, we have tazlito and Tiny
96 SliTaz for that. Seb is as close as possible of SliTaz first build, seb is
97 also a learning tool. Seb let you build sandbox os and rock solid web server.
99 * examples/ Various fs and scripts examples
100 * initfs/ Initial files used to create the system
101 * seb SliTaz Embedded operation system builder
102 * tools/ Various tools included or used to build an OS
103 * packages/ SliTaz Embedded packages
105 We dont want to much automation, let people create ther own OS in there
106 own way but provide some usefull function to help :-)
109 Gettext i18n
110 --------------------------------------------------------------------------------
111 No i18n with gettext in seb tools since seb distro dont include gettext-base.
114 ================================================================================