tazlito annotate doc/tazlito.ru.html @ rev 489

tazlito: fix efi.img md5sum
author Pascal Bellard <pascal.bellard@slitaz.org>
date Fri Mar 16 20:15:54 2018 +0100 (2018-03-16)
parents d7d87b67adeb
children
rev   line source
al@352 1 <!DOCTYPE html>
al@442 2 <html lang="ru">
al@352 3 <head>
al@352 4 <meta charset="utf-8" />
al@352 5 <title>Руководство TazLiTo — SliTaz Live Tool</title>
al@352 6 <link rel="shortcut icon" href="favicon.ico" />
al@352 7 <link rel="stylesheet" type="text/css" href="../slitaz-doc.css" />
al@352 8 <script type="text/javascript" src="../slitaz-doc.js"></script>
al@352 9 </head>
al@352 10 <body>
al@352 11
al@352 12 <header>
al@352 13 <h1>Руководство TazLiTo</h1>
al@352 14 </header>
al@352 15
al@352 16 <!-- Start content -->
al@352 17 <div id="content">
al@352 18
al@352 19 <h2>НАЗВАНИЕ</h2>
al@352 20
al@352 21 <p>TazLiTo — Sli<b>Taz</b> <b>Li</b>ve <b>To</b>ol.</p>
al@352 22
al@352 23
al@352 24 <h2>СИНТАКСИС</h2>
al@352 25
al@352 26 <pre>
al@352 27 tazlito [команда] [список|iso|flavor] [папка]
al@352 28 </pre>
al@352 29
al@352 30
al@352 31 <h2>ОПИСАНИЕ</h2>
al@352 32
al@352 33 <p>TazLiTo — маленькая утилита, которая поможет распаковать и пересобрать образ Live CD, изменить корневую файловую систему, упакованную в Live CD, создать дистрибутив, руководствуясь списком пакетов. Настройки TazLiTo, необходимые для работы, находятся в конфигурационном файле <tt>/etc/tazlito/tazlito.conf</tt> или в файле <tt>tazlito.conf</tt>, который можно создать в текущей папке. В конфигурационном файле указаны: имя файла ISO-образа, метка диска, сопровождающий, пути к пакетам дистрибутива и к создаваемому образу. При создании дистрибутива, TazLiTo может скопировать на Live CD дополнительные файлы из указанной папки.</p>
al@352 34 <p>Утилита TazLiTo распростаняется на условиях свободной лицензии GNU GPL v.3. Она установлена по умолчанию в SliTaz, устанавливалась и успешно тестировалась в Debian GNU/Linux. Узнать больше о создании Live CD вы сможете в Handbook.</p>
al@352 35
al@352 36
al@352 37 <h2>КОМАНДЫ</h2>
al@352 38
al@352 39
al@352 40 <h3 id="usage">usage</h3>
al@352 41
al@352 42 <p>Показать список доступных команд с кратким описанием.</p>
al@352 43
al@352 44 <pre>
al@352 45 # tazlito usage
al@352 46 </pre>
al@352 47
al@352 48
al@352 49 <h3 id="stats">stats</h3>
al@352 50
al@352 51 <p>Отобразить переменные конфигурации, пути к различным файлам и папкам, а также информацию о образе ISO.</p>
al@352 52
al@352 53 <pre>
al@352 54 # tazlito stats
al@352 55 </pre>
al@352 56
al@352 57
al@352 58 <h3 id="gen-config">gen-config</h3>
al@352 59
al@352 60 <p>Создать пример конфигурационного файла, который вы сможете править. По умолчанию файл создаётся в текущей папке, при необходимости вы можете указать другую папку в параметрах команды.</p>
al@352 61
al@352 62 <pre>
al@352 63 # tazlito gen-config
al@352 64 # tazlito gen-config <em>/путь/к/дистрибутиву</em>
al@352 65 </pre>
al@352 66
al@352 67
al@352 68 <h3 id="configure">configure</h3>
al@352 69
al@352 70 <p>Команда для интерактивного заполнения конфигурационного файла (системного или имеющегося в текущей папке).</p>
al@352 71
al@352 72 <pre>
al@352 73 # tazlito configure
al@352 74 </pre>
al@352 75
al@352 76
al@352 77 <h3 id="gen-iso">gen-iso</h3>
al@352 78
al@352 79 <p>Создать новый образ Live CD со всеми изменениями и дополнениями в корневой файловой системе, упакованной на CD-ROM. Для работы этой команде нужна папка, содержащая дерево дистрибутива системы Live. Это дерево можно легко создать командой <a href="#extract-distro"><code>extract-distro</code></a>, затем внести изменения и пересобрать.</p>
al@352 80
al@352 81 <pre>
al@352 82 # tazlito gen-iso
al@352 83 </pre>
al@352 84
al@352 85
al@352 86 <h3 id="gen-initiso">gen-initiso</h3>
al@352 87
al@352 88 <p>Эта команда делает ту же самую работу, что и <code>gen-iso</code>, но она сначала пересобирает initramfs. В initramfs содержится корневая файловая система, и она должна быть пересобрана в случае любых изменений в ней.</p>
al@352 89
al@352 90 <pre>
al@352 91 # tazlito gen-initiso
al@352 92 </pre>
al@352 93
al@352 94
al@352 95 <h3 id="list-flavors">list-flavors</h3>
al@352 96
al@352 97 <p>Загрузить (при необходимости) и показать список доступных редакций (flavor). Используя опцию <code>--recharge</code> вы можете принудительно загрузить новый список.</p>
al@352 98
al@352 99 <pre>
al@352 100 # tazlito list-flavors
al@352 101 # tazlito list-flavors --recharge
al@352 102 </pre>
al@352 103
al@352 104
al@352 105 <h3 id="get-flavor">get-flavor</h3>
al@352 106
al@352 107 <p>Загрузить (при необходимости) и подготовить файлы для работы команды <a href="#gen-distro"><code>gen-distro</code></a>, которая создаёт редакцию (flavor).</p>
al@352 108
al@352 109 <pre>
al@352 110 # tazlito get-flavor <em>указанный_flavor</em>
al@352 111 </pre>
al@352 112
al@352 113
al@352 114 <h3 id="show-flavors">show-flavor</h3>
al@352 115
al@352 116 <p>Показать описание редакции (flavor) и её размер после регенерации. Параметры <code>--brief</code> и <code>--noheader</code> сокращают количество отображаемой информации:</p>
al@352 117
al@352 118 <pre>
al@352 119 # tazlito show-flavor <em>указанный_flavor</em>
al@352 120 # tazlito show-flavor <em>указанный_flavor</em> --brief
al@352 121 # tazlito show-flavor <em>указанный_flavor</em> --brief --noheader
al@352 122 </pre>
al@352 123
al@352 124
al@352 125 <h3 id="gen-flavor">gen-flavor</h3>
al@352 126
al@352 127 <p>Создать файл описания новой редакции (flavor) в результате создания дистрибутива (<a href="#gen-distro"><code>gen-distro</code></a>). Файл <tt>.flavor</tt> можно прислать на slitaz.org:</p>
al@352 128
al@352 129 <pre>
al@352 130 # tazlito gen-flavor <em>новый_flavor</em>
al@352 131 </pre>
al@352 132
al@352 133
al@352 134 <h3 id="gen-liveflavor">gen-liveflavor</h3>
al@352 135
al@352 136 <p>Создать файл описания новой редакции (flavor) в результате создания дистрибутива, основанного на текущей системе. Параметр <code>--help</code> предоставляет дополнительную информацию:</p>
al@352 137
al@352 138 <pre>
al@352 139 # tazlito gen-liveflavor
al@352 140 # tazlito gen-liveflavor --help
al@352 141 </pre>
al@352 142
al@352 143
al@352 144 <h3 id="upgrade-flavor">upgrade-flavor</h3>
al@352 145
al@352 146 <p>Обновить файл редакции (flavor) путём обновления пакетов из списка до последних доступных версий:</p>
al@352 147
al@352 148 <pre>
al@352 149 # tazlito upgrade-flavor <em>указанный_flavor</em>
al@352 150 </pre>
al@352 151
al@352 152
al@352 153 <h3 id="extract-flavor">extract-flavor</h3>
al@352 154
al@352 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>
al@352 156
al@352 157 <pre>
al@352 158 # tazlito extract-flavor <em>указанный_flavor</em>
al@352 159 </pre>
al@352 160
al@352 161
al@352 162 <h3 id="pack-flavor">pack-flavor</h3>
al@352 163
al@352 164 <p>Преобразовать древовидную структуру по пути <tt>/home/slitaz/ВЕРСИЯ/flavors</tt> в файл flavor (файл<tt>.flavor</tt>). Эта команда противоположна команде <a href="#extract-flavor"><code>extract-flavor</code></a>:</p>
al@352 165
al@352 166 <pre>
al@352 167 # tazlito pack-flavor <em>указанный_flavor</em>
al@352 168 </pre>
al@352 169
al@352 170
al@352 171 <h3 id="extract-distro">extract-distro</h3>
al@352 172
al@352 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>
al@352 174
al@352 175 <pre>
al@352 176 # tazlito extract-distro <em>slitaz-cooking.iso</em>
al@352 177 </pre>
al@352 178
al@352 179
al@352 180 <h3 id="gen-distro">gen-distro</h3>
al@352 181
al@352 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>
al@352 183
al@352 184 <pre>
al@352 185 # tazlito gen-distro
al@352 186 # tazlito gen-distro --cdrom
al@352 187 # tazlito gen-distro --iso=<em>slitaz.iso</em>
al@352 188 # tazlito gen-distro <em>список_пакетов</em>
al@352 189 </pre>
al@352 190
al@352 191
al@352 192 <h3 id="clean-distro">clean-distro</h3>
al@352 193
al@352 194 <p>Удалить все созданные и распакованные файлы в структуре Live CD:</p>
al@352 195
al@352 196 <pre>
al@352 197 # tazlito clean-distro
al@352 198 </pre>
al@352 199
al@352 200
al@352 201 <h3 id="check-distro">check-distro</h3>
al@352 202
al@352 203 <p>Проверить, имеются ли в системе файлы установленных пакетов.</p>
al@352 204
al@352 205 <pre>
al@352 206 # tazlito check-distro
al@352 207 </pre>
al@352 208
al@352 209
al@352 210 <h3 id="writeiso">writeiso</h3>
al@352 211
al@352 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>
al@352 213
al@352 214 <pre>
al@352 215 # tazlito writeiso [gzip|lzma|none]
al@352 216 # tazlito writeiso gzip
al@352 217 # tazlito writeiso gzip <em>имя_образа</em>
al@352 218 </pre>
al@352 219
al@352 220 <h3 id="check-list">check-list</h3>
al@352 221
al@352 222 <p>Checks if the <tt>distro-packages.list</tt> is updated with the latest package versions:</p>
al@352 223
al@352 224 <pre>
al@352 225 # tazlito check-list
al@352 226 </pre>
al@352 227
al@352 228
al@352 229 <h3 id="repack">repack</h3>
al@352 230
al@352 231 <p>Перепаковать rootfs с наилучшей степенью сжатия.</p>
al@352 232
al@352 233 <pre>
al@352 234 # tazlito repack <em>slitaz.iso</em>
al@352 235 </pre>
al@352 236
al@352 237
al@352 238 <h3 id="merge">merge</h3>
al@352 239
al@352 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>
al@352 241
al@352 242 <pre>
al@352 243 # tazlito merge <em>160M slitaz-core.iso 96M rootfs-justx.gz 32M rootfs-base.gz</em>
al@352 244 </pre>
al@352 245
al@352 246
al@352 247 <h3 id="build-loram">build-loram</h3>
al@352 248
al@352 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>
al@352 250
al@352 251 <pre>
al@352 252 # tazlito build-loram <em>slitaz.iso loram.iso</em>
al@352 253 # tazlito build-loram <em>slitaz.iso loram-cdrom.iso</em> cdrom
al@352 254 </pre>
al@352 255
al@352 256
al@352 257 <h3 id="emu-iso">emu-iso</h3>
al@352 258
al@352 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>
al@352 260
al@352 261 <pre>
al@352 262 # tazlito emu-iso
al@352 263 # tazlito emu-iso path/to/image.iso
al@352 264 </pre>
al@352 265
al@352 266
al@352 267 <h3 id="burn-iso">burn-iso</h3>
al@352 268
al@352 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>
al@352 270
al@352 271 <pre>
al@352 272 # tazlito burn-iso
al@352 273 # tazlito burn-iso <em>slitaz-hacked.iso</em>
al@352 274 </pre>
al@352 275
al@352 276
al@352 277 <h2>РЕДАКЦИИ</h2>
al@352 278
al@352 279 <p>Файлы <tt>.flavor</tt> маленького размера, всего несколько килобайт. Они содержат достаточно информации для создания собственной редакции Live CD SliTaz.</p>
al@352 280
al@352 281
al@352 282 <h3 id="rebuild-flavor">Как изменить редакцию</h3>
al@352 283
al@352 284 <p>Свою редакцию можно создать на основе одной из имеющихся доступных редакций:</p>
al@352 285
al@352 286 <pre>
al@352 287 # tazlito list-flavors
al@352 288 </pre>
al@352 289
al@352 290 <table class="zebra outbox">
al@352 291 <caption>Список редакций</caption>
al@352 292 <thead>
al@352 293 <tr><th>Название</th><th>ISO</th><th>RootFS</th><th>Описание</th></tr>
al@352 294 </thead>
al@352 295 <tbody>
al@352 296 <tr><td>base</td>
al@352 297 <td>6.9M</td>
al@352 298 <td>13.1M</td>
al@352 299 <td>Минимальный набор пакетов для загрузки</td></tr>
al@352 300 <tr><td>core-3in1</td>
al@352 301 <td>31.5M</td>
al@352 302 <td>105.6M</td>
al@352 303 <td>Система SliTaz Core с альтернативами JustX и Base</td></tr>
al@352 304 <tr><td>core</td>
al@352 305 <td>31.5M</td>
al@352 306 <td>104.6M</td>
al@352 307 <td>Система SliTaz Core</td></tr>
al@352 308 <tr><td>eeepc</td>
al@352 309 <td>31.2M</td>
al@352 310 <td>105.4M</td>
al@352 311 <td>Система SliTaz Eee PC</td></tr>
al@352 312 <tr><td>justx</td>
al@352 313 <td>16.1M</td>
al@352 314 <td>51.2M</td>
al@352 315 <td>SliTaz с минимальным окружением X.Org</td></tr>
al@352 316 </tbody>
al@352 317 </table>
al@352 318
al@352 319 <p>Переделаем редакцию для Eee PC. Она использует 105,4 МБ ОЗУ и занимает 31,2 МБ на CD-ROM.</p>
al@352 320
al@352 321 <pre>
al@352 322 # tazlito clean-distro
al@352 323 # tazlito get-flavor <em>eeepc</em>
al@352 324 # tazlito gen-distro
al@352 325 </pre>
al@352 326
al@352 327
al@352 328 <h3 id="create-flavor">Как создать редакцию</h3>
al@352 329
al@352 330 <p>Создать свою редакцию можно одним из трёх способов:</p>
al@352 331
al@352 332 <ul>
al@352 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>
al@352 334 <li>Создать древовидную структуру, которая описывает редакцию (см. <a href="#extract-flavor"><code>tazlito extract-flavor</code></a>), а затем создать редакцию командой <a href="#pack-flavor"><code>tazlito pack-flavor</code></a>.</li>
al@352 335 <li>Воспользоваться нашим <a href="http://pizza.slitaz.org/">онлайн сервисом</a>.</li>
al@352 336 </ul>
al@352 337
al@352 338
al@352 339 <h3 id="publish-flavor">Как поделиться редакцией</h3>
al@352 340
al@352 341 <p>Файл <tt>.flavor</tt> маленького размера, его можно отправить в <a href="http://www.slitaz.org/ru/mailing-list.php">рассылку SliTaz</a>.</p>
al@352 342
al@352 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>
al@352 344 <p>Структура включает в себя:</p>
al@352 345
al@352 346 <ul>
al@352 347 <li><b>receipt</b> — следующие переменные в рецепте описывают редакцию:
al@352 348 <table class="zebra outbox"><tbody>
al@352 349 <tr><td>FLAVOR</td><td>название редакции</td></tr>
al@352 350 <tr><td>SHORT_DESC</td><td>краткое описание</td></tr>
al@352 351 <tr><td>VERSION</td><td>версия (в свободном формате)</td></tr>
al@352 352 <tr><td>MAINTAINER</td><td>адрес почты сопровождающего</td></tr>
al@352 353 <tr><td>FRUGAL_RAM*</td><td>минимально необходимый размер ОЗУ</td></tr>
al@352 354 <tr><td>ROOTFS_SIZE*</td><td>размер, занимаемый распакованным rootfs.gz в ОЗУ</td></tr>
al@352 355 <tr><td>INITRAMFS_SIZE*</td><td>размер rootfs.gz на CD-ROM</td></tr>
al@352 356 <tr><td>ISO_SIZE*</td><td>размер образа CD-ROM</td></tr>
al@352 357 <tr><td>ROOTFS_SELECTION*</td><td>см. ниже <a href="#meta-flavor">Мета-редакция</a></td></tr>
al@352 358 </tbody></table>
al@352 359 Переменные, отмеченные звёздочкой, можно не указывать.
al@352 360 </li>
al@352 361 <li><b>packages.list</b> — в файле содержится список пакетов без указания их версий (TazLiTo загружает самые последние доступные версии). Этот файл отсутствует, если переменная ROOTFS_SELECTION указана в рецепте.</li>
al@352 362 <li><b>mirrors</b> — не обязательный файл, в котором можно указать список неофициалных зеркал (undigest), на которых располагаются личные пакеты.</li>
al@352 363 <li><b>rootfs</b> — не обязательная папка, в которую можно поместить дерево файловой системы. Файлы отсюда (обычно, это файлы настроек) будут добавлены в корневую файловую систему, находящуюся в rootfs.gz.</li>
al@352 364 <li><b>rootcd</b> — не обязательная папка, в которую можно поместить дерево файловой системы. Файлы отсюда будут добавлены в файловую систему CD-ROM.</li>
al@352 365 </ul>
al@352 366
al@352 367
al@352 368 <h3 id="tune-flavor">Как доработать редакцию</h3>
al@352 369
al@352 370 <p>Часто проще изменить существующую редакцию, чем создавать новую с нуля. Например, так можно доработать редакцию для Eee PC:</p>
al@352 371
al@352 372 <pre>
al@352 373 # tazpkg get-install mercurial
al@352 374 # cd /home/slitaz
al@352 375 # hg clone http://hg.slitaz.org/flavors
al@352 376 # cd flavors
al@352 377 # cp -a <em>eeepc myslitaz</em>
al@352 378 </pre>
al@352 379
al@352 380 <p>Теперь можно изменить файлы в папке <tt>myslitaz</tt>, а затем следующей командой создать новую редакцию:</p>
al@352 381
al@352 382 <pre>
al@352 383 # tazlito pack-flavor <em>myslitaz</em>
al@352 384 </pre>
al@352 385
al@352 386 <p>Совет: можно не устанавливать mercurial и распаковать файл <tt>flavor</tt> соответствующей командой. Вот как будет выглядеть предыдущий пример:</p>
al@352 387
al@352 388 <pre>
al@352 389 # tazlito get-flavor <em>eeepc</em>
al@352 390 # tazlito extract-flavor <em>eeepc.flavor</em>
al@352 391 # cd /home/slitaz/flavors
al@352 392 # cp -a <em>eeepc myslitaz</em>
al@352 393 </pre>
al@352 394
al@352 395
al@352 396 <h3 id="meta-flavor">Мета-редакция</h3>
al@352 397
al@352 398 <p>Мета-редакция включает в себя несколько обычных редакций, вложенных одна в другую как матрёшки. В зависимости от объёма ОЗУ будет запущена соответствующая редакция. В переменной <tt>ROOTFS_SELECTION</tt> указан минимальный объём ОЗУ и соответствующая ему редакция, <a href="http://hg.slitaz.org/flavors/file/tip/core-4in1/receipt">пример</a>:</p>
al@352 399
al@352 400 <pre>
al@352 401 ROOTFS_SELECTION="160M core 96M justx 32M base"
al@352 402 </pre>
al@352 403
al@352 404 <p>Мета-редакция не содержит список пакетов (<tt>packages.list</tt>). Версии SliTaz, основанные на ядре Linux до 2.6.30, не поддерживают мета-редакции.</p>
al@352 405
al@352 406
al@352 407 <h2>СОПРОВОЖДАЮЩИЕ</h2>
al@352 408
al@352 409 <p>Christophe Lincoln &lt;pankso at slitaz.org&gt;<br />
al@352 410 Pascal Bellard &lt;pascal.bellard at slitaz.org&gt;</p>
al@352 411
al@352 412 <!-- End content -->
al@352 413 </div>
al@352 414
al@352 415 <footer>
pascal@466 416 Copyright &copy; <span class="year"></span> <a href="http://www.slitaz.org/">SliTaz GNU/Linux</a>
al@352 417 </footer>
al@352 418
al@352 419 </body>
al@352 420 </html>