seb view README @ rev 11
More security, -e to emulate iso
| author | Christophe Lincoln <pankso@slitaz.org> |
|---|---|
| date | Mon Mar 06 19:06:12 2017 +0100 (2017-03-06) |
| parents | a4fa34b33e9e |
| children | ac5daac524c9 |
line source
1 SEB - SliTaz Embedded OS
2 ================================================================================
4 Back to the root with this cmdline tool to build realy small SliTaz text mode
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
47 To get a list of commands, just run seb without arguments: $ seb
50 Build process & environment
51 --------------------------------------------------------------------------------
52 Seb is not compliling any tools, it will use SliTaz standard executable and
53 libraries - Seb OS is created on top of SliTaz. Packages installed in seb must
54 be on the build host, this is the case for the full basic sysem.
56 Seb will build the custom operating system into the current directory or it
57 will read a build.conf file to know the path to the work/build folder. Seb will
58 use these directories to work:
60 * rootfs/ The root filsysytem of the compressed operationg system
61 * rootiso/ Root of the ISO image with rootfs.gz, bootloader and kernel
62 * sebfs/ Custom files overwritting file into the rootfs
63 * sebpkgs/ The packages to install into the distro
66 Frugal install
67 --------------------------------------------------------------------------------
68 A frugal installation let you boot your seb system without any installation and
69 with the all system running in memory. Basicaly you need to have the rootfs.gz
70 and the kernel in the /boot tree and a entry in Grub configuration file. SliTaz
71 provide a nifty little tools for frugal install:
73 # frugal path/to/image.iso
75 Grub entry will need a rdinit=/sbin/init on the kernel line. Here is an example:
77 # Seb OS Frugal on sdb1
78 title SliTaz Embedded OS (frugal)
79 root (hd0,0)
80 kernel /boot/frugal/bzImage root=/dev/null rdinit=/sbin/init
81 initrd /boot/frugal/rootfs.gz
84 Virtual disk
85 --------------------------------------------------------------------------------
86 A virtual disk let you have a persitstant filesystem when using Qemu or booting,
87 in frugal mode (recommended). It is useful when developping/debugging scripts
88 that runs into a seb-os or to host web server virtual hosts. Create, mount or
89 umount disk:
91 # seb disk
94 Source code and devel guidelines
95 --------------------------------------------------------------------------------
96 Note even need to say that this tool MUST stay simple, fast, elegant and fun.
97 We dont want a super tool for complex system building, we have tazlito and Tiny
98 SliTaz for that. Seb is as close as possible of SliTaz first build, seb is
99 also a learning tool. Seb let you build sandbox os and rock solid web server.
101 * examples/ Various fs and scripts examples
102 * initfs/ Initial files used to create the system
103 * seb SliTaz Embedded operation system builder
104 * libseb.sh Seb shared functions install on host and in seb OS
105 * tools/ Various tools included or used to build an OS
106 * packages/ SliTaz Embedded packages database
108 We dont want to much automation, let people create ther own OS in there
109 own way but provide some usefull function to help :-)
112 Gettext i18n
113 --------------------------------------------------------------------------------
114 No i18n with gettext in seb tools since seb distro dont include gettext-base.
117 ================================================================================