tazlito view doc/tazlito.ru.html @ rev 523
Fix perms
| author | Pascal Bellard <pascal.bellard@slitaz.org> |
|---|---|
| date | Wed Dec 04 14:45:21 2019 +0100 (2019-12-04) |
| parents | d7d87b67adeb |
| children |
line source
1 <!DOCTYPE html>
2 <html lang="ru">
3 <head>
4 <meta charset="utf-8" />
5 <title>Руководство TazLiTo — SliTaz Live Tool</title>
6 <link rel="shortcut icon" href="favicon.ico" />
7 <link rel="stylesheet" type="text/css" href="../slitaz-doc.css" />
8 <script type="text/javascript" src="../slitaz-doc.js"></script>
9 </head>
10 <body>
12 <header>
13 <h1>Руководство TazLiTo</h1>
14 </header>
16 <!-- Start content -->
17 <div id="content">
19 <h2>НАЗВАНИЕ</h2>
21 <p>TazLiTo — Sli<b>Taz</b> <b>Li</b>ve <b>To</b>ol.</p>
24 <h2>СИНТАКСИС</h2>
26 <pre>
27 tazlito [команда] [список|iso|flavor] [папка]
28 </pre>
31 <h2>ОПИСАНИЕ</h2>
33 <p>TazLiTo — маленькая утилита, которая поможет распаковать и пересобрать образ Live CD, изменить корневую файловую систему, упакованную в Live CD, создать дистрибутив, руководствуясь списком пакетов. Настройки TazLiTo, необходимые для работы, находятся в конфигурационном файле <tt>/etc/tazlito/tazlito.conf</tt> или в файле <tt>tazlito.conf</tt>, который можно создать в текущей папке. В конфигурационном файле указаны: имя файла ISO-образа, метка диска, сопровождающий, пути к пакетам дистрибутива и к создаваемому образу. При создании дистрибутива, TazLiTo может скопировать на Live CD дополнительные файлы из указанной папки.</p>
34 <p>Утилита TazLiTo распростаняется на условиях свободной лицензии GNU GPL v.3. Она установлена по умолчанию в SliTaz, устанавливалась и успешно тестировалась в Debian GNU/Linux. Узнать больше о создании Live CD вы сможете в Handbook.</p>
37 <h2>КОМАНДЫ</h2>
40 <h3 id="usage">usage</h3>
42 <p>Показать список доступных команд с кратким описанием.</p>
44 <pre>
45 # tazlito usage
46 </pre>
49 <h3 id="stats">stats</h3>
51 <p>Отобразить переменные конфигурации, пути к различным файлам и папкам, а также информацию о образе ISO.</p>
53 <pre>
54 # tazlito stats
55 </pre>
58 <h3 id="gen-config">gen-config</h3>
60 <p>Создать пример конфигурационного файла, который вы сможете править. По умолчанию файл создаётся в текущей папке, при необходимости вы можете указать другую папку в параметрах команды.</p>
62 <pre>
63 # tazlito gen-config
64 # tazlito gen-config <em>/путь/к/дистрибутиву</em>
65 </pre>
68 <h3 id="configure">configure</h3>
70 <p>Команда для интерактивного заполнения конфигурационного файла (системного или имеющегося в текущей папке).</p>
72 <pre>
73 # tazlito configure
74 </pre>
77 <h3 id="gen-iso">gen-iso</h3>
79 <p>Создать новый образ Live CD со всеми изменениями и дополнениями в корневой файловой системе, упакованной на CD-ROM. Для работы этой команде нужна папка, содержащая дерево дистрибутива системы Live. Это дерево можно легко создать командой <a href="#extract-distro"><code>extract-distro</code></a>, затем внести изменения и пересобрать.</p>
81 <pre>
82 # tazlito gen-iso
83 </pre>
86 <h3 id="gen-initiso">gen-initiso</h3>
88 <p>Эта команда делает ту же самую работу, что и <code>gen-iso</code>, но она сначала пересобирает initramfs. В initramfs содержится корневая файловая система, и она должна быть пересобрана в случае любых изменений в ней.</p>
90 <pre>
91 # tazlito gen-initiso
92 </pre>
95 <h3 id="list-flavors">list-flavors</h3>
97 <p>Загрузить (при необходимости) и показать список доступных редакций (flavor). Используя опцию <code>--recharge</code> вы можете принудительно загрузить новый список.</p>
99 <pre>
100 # tazlito list-flavors
101 # tazlito list-flavors --recharge
102 </pre>
105 <h3 id="get-flavor">get-flavor</h3>
107 <p>Загрузить (при необходимости) и подготовить файлы для работы команды <a href="#gen-distro"><code>gen-distro</code></a>, которая создаёт редакцию (flavor).</p>
109 <pre>
110 # tazlito get-flavor <em>указанный_flavor</em>
111 </pre>
114 <h3 id="show-flavors">show-flavor</h3>
116 <p>Показать описание редакции (flavor) и её размер после регенерации. Параметры <code>--brief</code> и <code>--noheader</code> сокращают количество отображаемой информации:</p>
118 <pre>
119 # tazlito show-flavor <em>указанный_flavor</em>
120 # tazlito show-flavor <em>указанный_flavor</em> --brief
121 # tazlito show-flavor <em>указанный_flavor</em> --brief --noheader
122 </pre>
125 <h3 id="gen-flavor">gen-flavor</h3>
127 <p>Создать файл описания новой редакции (flavor) в результате создания дистрибутива (<a href="#gen-distro"><code>gen-distro</code></a>). Файл <tt>.flavor</tt> можно прислать на slitaz.org:</p>
129 <pre>
130 # tazlito gen-flavor <em>новый_flavor</em>
131 </pre>
134 <h3 id="gen-liveflavor">gen-liveflavor</h3>
136 <p>Создать файл описания новой редакции (flavor) в результате создания дистрибутива, основанного на текущей системе. Параметр <code>--help</code> предоставляет дополнительную информацию:</p>
138 <pre>
139 # tazlito gen-liveflavor
140 # tazlito gen-liveflavor --help
141 </pre>
144 <h3 id="upgrade-flavor">upgrade-flavor</h3>
146 <p>Обновить файл редакции (flavor) путём обновления пакетов из списка до последних доступных версий:</p>
148 <pre>
149 # tazlito upgrade-flavor <em>указанный_flavor</em>
150 </pre>
153 <h3 id="extract-flavor">extract-flavor</h3>
155 <p>Преобразовать flavor в древовидную структуру по пути <tt>/home/slitaz/ВЕРСИЯ/flavors</tt>, которую можно легко модифицировать. Работа над официальными flavor ведётся в mercurial: <a href="http://hg.slitaz.org/flavors">hg.slitaz.org/flavors</a>. К примеру, в системе Cooking рабочей папкой будет являться <tt>/home/slitaz/cooking</tt>.</p>
157 <pre>
158 # tazlito extract-flavor <em>указанный_flavor</em>
159 </pre>
162 <h3 id="pack-flavor">pack-flavor</h3>
164 <p>Преобразовать древовидную структуру по пути <tt>/home/slitaz/ВЕРСИЯ/flavors</tt> в файл flavor (файл<tt>.flavor</tt>). Эта команда противоположна команде <a href="#extract-flavor"><code>extract-flavor</code></a>:</p>
166 <pre>
167 # tazlito pack-flavor <em>указанный_flavor</em>
168 </pre>
171 <h3 id="extract-distro">extract-distro</h3>
173 <p>Распаковать образ ISO Live CD для внесения изменений в структуру файловой системы, находящейся на CD-ROM. После распаковки можно внести изменения и дополнения, а затем создать новый образ ISO командой <a href="#gen-iso"><code>gen-iso</code></a> или <a href="#gen-initiso"><code>gen-initiso</code></a>. Пример использования:</p>
175 <pre>
176 # tazlito extract-distro <em>slitaz-cooking.iso</em>
177 </pre>
180 <h3 id="gen-distro">gen-distro</h3>
182 <p>The <em>Generate Distribution</em> command can generate the distro-tree and an ISO image via a list of packages. To function, this command needs a list of packages, a directory containing all the (<tt>.tazpkg</tt>) packages on the list, and a directory to generate the distribution. The list of packages can be extracted from a flavor with the <a href="#get-flavor"><code>get-flavor</code></a> command. If one uses the LiveCD, the options <code>--cdrom</code> and <code>--iso=</code> permit the regeneration of packages that place files in <tt>/boot</tt> without being obliged to download them and recovers the additional files of the LiveCD. The path to the various directories are configured in the configuration file and packages can be downloaded from the SliTaz mirrors or generated by Cookutils. To generate a distribution:</p>
184 <pre>
185 # tazlito gen-distro
186 # tazlito gen-distro --cdrom
187 # tazlito gen-distro --iso=<em>slitaz.iso</em>
188 # tazlito gen-distro <em>список_пакетов</em>
189 </pre>
192 <h3 id="clean-distro">clean-distro</h3>
194 <p>Удалить все созданные и распакованные файлы в структуре Live CD:</p>
196 <pre>
197 # tazlito clean-distro
198 </pre>
201 <h3 id="check-distro">check-distro</h3>
203 <p>Проверить, имеются ли в системе файлы установленных пакетов.</p>
205 <pre>
206 # tazlito check-distro
207 </pre>
210 <h3 id="writeiso">writeiso</h3>
212 <p>This command will write the current filesystem to a cpio archive (<tt>rootfs.gz</tt>) and then generate a bootable ISO image. Writeiso can be used in a HD install or in live mode and will also archive your current <tt>/home</tt> directory. This command lets you easily remaster and build your own LiveCD image, just boot, modify any files, and then:</p>
214 <pre>
215 # tazlito writeiso [gzip|lzma|none]
216 # tazlito writeiso gzip
217 # tazlito writeiso gzip <em>имя_образа</em>
218 </pre>
220 <h3 id="check-list">check-list</h3>
222 <p>Checks if the <tt>distro-packages.list</tt> is updated with the latest package versions:</p>
224 <pre>
225 # tazlito check-list
226 </pre>
229 <h3 id="repack">repack</h3>
231 <p>Перепаковать rootfs с наилучшей степенью сжатия.</p>
233 <pre>
234 # tazlito repack <em>slitaz.iso</em>
235 </pre>
238 <h3 id="merge">merge</h3>
240 <p>Combines several flavors like nested Russian dolls. Each rootfs is a subset of the previous. The first rootfs is extracted from the ISO image used in the third argument. The flavor will then be chosen to launch at startup according to the amount of RAM available:</p>
242 <pre>
243 # tazlito merge <em>160M slitaz-core.iso 96M rootfs-justx.gz 32M rootfs-base.gz</em>
244 </pre>
247 <h3 id="build-loram">build-loram</h3>
249 <p>Creates an ISO image flavor for low RAM systems from a SliTaz ISO image. You can build a flavor with <tt>/</tt> always in RAM or where <tt>/</tt> resides on the CD-ROM:</p>
251 <pre>
252 # tazlito build-loram <em>slitaz.iso loram.iso</em>
253 # tazlito build-loram <em>slitaz.iso loram-cdrom.iso</em> cdrom
254 </pre>
257 <h3 id="emu-iso">emu-iso</h3>
259 <p>The <code>emu-iso</code> command uses the Qemu emulator to start and run SliTaz. Qemu is used to test the newly built ISO image without burning to a CD-ROM or booting into frugal mode:</p>
261 <pre>
262 # tazlito emu-iso
263 # tazlito emu-iso path/to/image.iso
264 </pre>
267 <h3 id="burn-iso">burn-iso</h3>
269 <p><code>burn-iso</code> will guess the CD-ROM device and its speed, and wodim (part of cdrkit) will begin to burn an ISO image. The default ISO image is the one located in the current configuration file, but it's possible to specify a different image via the command line:</p>
271 <pre>
272 # tazlito burn-iso
273 # tazlito burn-iso <em>slitaz-hacked.iso</em>
274 </pre>
277 <h2>РЕДАКЦИИ</h2>
279 <p>Файлы <tt>.flavor</tt> маленького размера, всего несколько килобайт. Они содержат достаточно информации для создания собственной редакции Live CD SliTaz.</p>
282 <h3 id="rebuild-flavor">Как изменить редакцию</h3>
284 <p>Свою редакцию можно создать на основе одной из имеющихся доступных редакций:</p>
286 <pre>
287 # tazlito list-flavors
288 </pre>
290 <table class="zebra outbox">
291 <caption>Список редакций</caption>
292 <thead>
293 <tr><th>Название</th><th>ISO</th><th>RootFS</th><th>Описание</th></tr>
294 </thead>
295 <tbody>
296 <tr><td>base</td>
297 <td>6.9M</td>
298 <td>13.1M</td>
299 <td>Минимальный набор пакетов для загрузки</td></tr>
300 <tr><td>core-3in1</td>
301 <td>31.5M</td>
302 <td>105.6M</td>
303 <td>Система SliTaz Core с альтернативами JustX и Base</td></tr>
304 <tr><td>core</td>
305 <td>31.5M</td>
306 <td>104.6M</td>
307 <td>Система SliTaz Core</td></tr>
308 <tr><td>eeepc</td>
309 <td>31.2M</td>
310 <td>105.4M</td>
311 <td>Система SliTaz Eee PC</td></tr>
312 <tr><td>justx</td>
313 <td>16.1M</td>
314 <td>51.2M</td>
315 <td>SliTaz с минимальным окружением X.Org</td></tr>
316 </tbody>
317 </table>
319 <p>Переделаем редакцию для Eee PC. Она использует 105,4 МБ ОЗУ и занимает 31,2 МБ на CD-ROM.</p>
321 <pre>
322 # tazlito clean-distro
323 # tazlito get-flavor <em>eeepc</em>
324 # tazlito gen-distro
325 </pre>
328 <h3 id="create-flavor">Как создать редакцию</h3>
330 <p>Создать свою редакцию можно одним из трёх способов:</p>
332 <ul>
333 <li>Создать образ Live CD командой <a href="#gen-distro"><code>tazlito gen-distro</code></a>, а затем создать файл <tt>flavor</tt> командой <a href="#gen-flavor"><code>tazlito gen-flavor</code></a>.</li>
334 <li>Создать древовидную структуру, которая описывает редакцию (см. <a href="#extract-flavor"><code>tazlito extract-flavor</code></a>), а затем создать редакцию командой <a href="#pack-flavor"><code>tazlito pack-flavor</code></a>.</li>
335 <li>Воспользоваться нашим <a href="http://pizza.slitaz.org/">онлайн сервисом</a>.</li>
336 </ul>
339 <h3 id="publish-flavor">Как поделиться редакцией</h3>
341 <p>Файл <tt>.flavor</tt> маленького размера, его можно отправить в <a href="http://www.slitaz.org/ru/mailing-list.php">рассылку SliTaz</a>.</p>
343 <p>Результат выполнения команды <a href="#extract-flavor"><code>tazlito extract-flavor</code></a> можно разместить в <a href="http://hg.slitaz.org/flavors">репозитории</a>. В этом случае древовидная структура будет непосредственно видна в <a href="http://hg.slitaz.org/flavors/file/tip">веб-интерфейсе mercurial</a>.</p>
344 <p>Структура включает в себя:</p>
346 <ul>
347 <li><b>receipt</b> — следующие переменные в рецепте описывают редакцию:
348 <table class="zebra outbox"><tbody>
349 <tr><td>FLAVOR</td><td>название редакции</td></tr>
350 <tr><td>SHORT_DESC</td><td>краткое описание</td></tr>
351 <tr><td>VERSION</td><td>версия (в свободном формате)</td></tr>
352 <tr><td>MAINTAINER</td><td>адрес почты сопровождающего</td></tr>
353 <tr><td>FRUGAL_RAM*</td><td>минимально необходимый размер ОЗУ</td></tr>
354 <tr><td>ROOTFS_SIZE*</td><td>размер, занимаемый распакованным rootfs.gz в ОЗУ</td></tr>
355 <tr><td>INITRAMFS_SIZE*</td><td>размер rootfs.gz на CD-ROM</td></tr>
356 <tr><td>ISO_SIZE*</td><td>размер образа CD-ROM</td></tr>
357 <tr><td>ROOTFS_SELECTION*</td><td>см. ниже <a href="#meta-flavor">Мета-редакция</a></td></tr>
358 </tbody></table>
359 Переменные, отмеченные звёздочкой, можно не указывать.
360 </li>
361 <li><b>packages.list</b> — в файле содержится список пакетов без указания их версий (TazLiTo загружает самые последние доступные версии). Этот файл отсутствует, если переменная ROOTFS_SELECTION указана в рецепте.</li>
362 <li><b>mirrors</b> — не обязательный файл, в котором можно указать список неофициалных зеркал (undigest), на которых располагаются личные пакеты.</li>
363 <li><b>rootfs</b> — не обязательная папка, в которую можно поместить дерево файловой системы. Файлы отсюда (обычно, это файлы настроек) будут добавлены в корневую файловую систему, находящуюся в rootfs.gz.</li>
364 <li><b>rootcd</b> — не обязательная папка, в которую можно поместить дерево файловой системы. Файлы отсюда будут добавлены в файловую систему CD-ROM.</li>
365 </ul>
368 <h3 id="tune-flavor">Как доработать редакцию</h3>
370 <p>Часто проще изменить существующую редакцию, чем создавать новую с нуля. Например, так можно доработать редакцию для Eee PC:</p>
372 <pre>
373 # tazpkg get-install mercurial
374 # cd /home/slitaz
375 # hg clone http://hg.slitaz.org/flavors
376 # cd flavors
377 # cp -a <em>eeepc myslitaz</em>
378 </pre>
380 <p>Теперь можно изменить файлы в папке <tt>myslitaz</tt>, а затем следующей командой создать новую редакцию:</p>
382 <pre>
383 # tazlito pack-flavor <em>myslitaz</em>
384 </pre>
386 <p>Совет: можно не устанавливать mercurial и распаковать файл <tt>flavor</tt> соответствующей командой. Вот как будет выглядеть предыдущий пример:</p>
388 <pre>
389 # tazlito get-flavor <em>eeepc</em>
390 # tazlito extract-flavor <em>eeepc.flavor</em>
391 # cd /home/slitaz/flavors
392 # cp -a <em>eeepc myslitaz</em>
393 </pre>
396 <h3 id="meta-flavor">Мета-редакция</h3>
398 <p>Мета-редакция включает в себя несколько обычных редакций, вложенных одна в другую как матрёшки. В зависимости от объёма ОЗУ будет запущена соответствующая редакция. В переменной <tt>ROOTFS_SELECTION</tt> указан минимальный объём ОЗУ и соответствующая ему редакция, <a href="http://hg.slitaz.org/flavors/file/tip/core-4in1/receipt">пример</a>:</p>
400 <pre>
401 ROOTFS_SELECTION="160M core 96M justx 32M base"
402 </pre>
404 <p>Мета-редакция не содержит список пакетов (<tt>packages.list</tt>). Версии SliTaz, основанные на ядре Linux до 2.6.30, не поддерживают мета-редакции.</p>
407 <h2>СОПРОВОЖДАЮЩИЕ</h2>
409 <p>Christophe Lincoln <pankso at slitaz.org><br />
410 Pascal Bellard <pascal.bellard at slitaz.org></p>
412 <!-- End content -->
413 </div>
415 <footer>
416 Copyright © <span class="year"></span> <a href="http://www.slitaz.org/">SliTaz GNU/Linux</a>
417 </footer>
419 </body>
420 </html>