slitaz-arm view README @ rev 83
README typo
| author | Paul Issott <paul@slitaz.org> |
|---|---|
| date | Sun Mar 30 08:55:53 2014 +0100 (2014-03-30) |
| parents | a92d7d48dd29 |
| children | bfdc7cc1c657 |
line source
1 SliTaz ARM
2 ================================================================================
5 SliTaz ARM tools and files
8 Build tools installation
9 --------------------------------------------------------------------------------
10 To install 'sat' and 'sat-rpi' you need to have make installed or copy the 2
11 files to /usr/bin:
13 # make install
16 Sat quickstart
17 --------------
18 Sat is a tool in the spirit of all SliTaz tools, all commands and options are
19 accessible via: sat usage or help. To create a distro you first need to have
20 some ARM packages. You can use custom cook or the one from the SliTaz mirror.
21 Put all your custom *.tazpkgs in the packages/ directory and sat will install
22 them. To use the official packages you need to sync the mirror with:
24 # sat mirror
26 Generate the distro initramfs with your custom --options:
28 # sat gen --flavor=base --kmap
30 To boot the distro with Qemu you can run:
32 # sat emu
35 ARM packages mirror
36 --------------------------------------------------------------------------------
37 Sat lets you clone the ARM cooking mirror to let you debug and try official ARM
38 packages. Sat will create a mirror directory in the working path and download
39 all lists and packages. After a first clone it will only check the repo ID
40 file and download any modified or new packages.
43 Custom SliTaz system files: rootfs/
44 --------------------------------------------------------------------------------
45 Custom SliTaz ARM scripts and files used to generate a distro. These files
46 and any other system files can be erased or added via the flavors support. The
47 rootfs files can also be directly modified before generating a new distro.
50 CGI Admin web interface: cgi-adm/
51 --------------------------------------------------------------------------------
52 Very small and fast CGI SHell admin/info web interface for ARM devices with
53 plugins support. The goal is not to rewrite TazPanel but to have a light CGI
54 toolkit to code specific ARM devices plugins such as boot configs for the
55 Raspberry Pi. In the plugins directory you will find a skeleton to start
56 your custom plugin. You can also create general purpose or hardware specific
57 plugins.
59 The root directory is: /var/www/adm and the default web server is Busybox HTTPd.
60 So just start the web server and connect to the IP address of your machine:
62 # startd httpd
64 URL form: http://192.rpi.ip/adm/
66 On SliTaz i486 you can also use Busybox HTTPd and install the cgi-adm files
67 under /var/www and code directly then copy or upload your plugin to your ARM
68 devices.
70 # make install-cgi
73 Bugs
74 --------------------------------------------------------------------------------
75 Please report bugs on the Slitaz Bug Tracker: http://bugs.slitaz.org/
78 History
79 --------------------------------------------------------------------------------
80 While I was porting SliTaz to ARM I ended up by creating a lot of initramfs'
81 to test the SliTaz boot, packages and so on. So I first wrote a small script,
82 then improved it by just having to put include packages in a single directory
83 and all custom files in a rootfs directory. I also wanted virtual disk support
84 so I can code under Qemu and save my work. This is how sat was born, one day
85 we may use TazLito or have a new SliTaz Live tool, but for the time being 'sat'
86 and the way it works fits all my needs to build custom distros and then boot
87 with qemu-system-arm.
89 - Pankso 24 May 2012
92 ================================================================================