tazpkg diff doc/tazpkg.ru.html @ rev 828
Add modules "info", "list" with extended functions; update documentations and translations
author | Aleksej Bobylev <al.bobylev@gmail.com> |
---|---|
date | Tue Aug 11 01:09:15 2015 +0300 (2015-08-11) |
parents | a73c9918a5de |
children | f1c82b2d20aa |
line diff
1.1 --- a/doc/tazpkg.ru.html Thu Jun 04 00:15:13 2015 +0300 1.2 +++ b/doc/tazpkg.ru.html Tue Aug 11 01:09:15 2015 +0300 1.3 @@ -17,19 +17,19 @@ 1.4 <div id="content"> 1.5 1.6 1.7 -<h2>НАЗВАНИЕ</h2> 1.8 +<h2>Название</h2> 1.9 1.10 <p>TazPkg — менеджер пакетов в системе SliTaz GNU/Linux.</p> 1.11 1.12 1.13 -<h2>СИНТАКСИС</h2> 1.14 +<h2>Синтаксис</h2> 1.15 1.16 <pre> 1.17 tazpkg [команда] [параметры...] 1.18 </pre> 1.19 1.20 1.21 -<h2>ОПИСАНИЕ</h2> 1.22 +<h2>Описание</h2> 1.23 1.24 <p>TazPkg — это легковесный менеджер пакетов, позволяющий устанавливать, выдавать списки, загружать, 1.25 обновлять и удалять бинарные пакеты в системе GNU/Linux. TazPkg предоставляет команды для поиска 1.26 @@ -44,7 +44,186 @@ 1.27 лицензией GNU GPL v3.</p> 1.28 1.29 1.30 -<h2>КОМАНДЫ</h2> 1.31 +<h2>Окружение</h2> 1.32 + 1.33 +<p>TazPkg использует некоторые переменные окружения:</p> 1.34 + 1.35 +<ul> 1.36 + <li><tt>LANGUAGE</tt>: определяет язык вывода и подтверждений пользователя. <x-details>Обратите 1.37 + внимание, переменные окружения <tt>LANG</tt> и <tt>LC_ALL</tt> также оказывают влияние на 1.38 + язык вывода</x-details></li> 1.39 + <li><tt>LC_TIME</tt>: определяет формат даты в команде <a href="#activity">activity</a></li> 1.40 + <!-- li><tt>TAZPKG_ROOT</tt>: если определено, то указывает на корень файловой системы, в которой 1.41 + должен работать TazPkg. Имейте в виду, значение, указанное при помощи параметра 1.42 + <tt>--root=</tt> имеет приоритет над этой переменной окружения</li --> 1.43 +</ul> 1.44 + 1.45 + 1.46 +<h2>Файлы</h2> 1.47 + 1.48 + 1.49 +<h3>Конфигурационные файлы</h3> 1.50 + 1.51 +<ul> 1.52 + <li><tt><a href="file:///etc/slitaz/slitaz.conf" 1.53 + target="_blank">/etc/slitaz/slitaz.conf</a></tt></li> 1.54 + <li><tt><a href="file:///etc/slitaz/tazpkg.conf" 1.55 + target="_blank">/etc/slitaz/tazpkg.conf</a></tt></li> 1.56 +</ul> 1.57 + 1.58 + 1.59 +<h3>Файлы базы данных пакетов</h3> 1.60 + 1.61 +<p>База данных пакетов по умолчанию располагается в папке <tt>/var/lib/tazpkg</tt>.</p> 1.62 + 1.63 +<ul> 1.64 + <li><tt><a href="file:///var/lib/tazpkg/ID" target="_blank">ID</a></tt> (устарел): идентификатор 1.65 + текущего состояния репозитория SliTaz. <x-details>Значение изменяется, когда новые или 1.66 + обновленные пакеты появляются в репозитории.</x-details></li> 1.67 + <li><tt><a href="file:///var/lib/tazpkg/IDs" target="_blank">IDs</a></tt>: идентификатор 1.68 + текущего состояния репозитория SliTaz и отпечаток времени UNIX. <x-details>Значение 1.69 + идентификатора изменяется, когда новые или обновленные пакеты появляются в репозитории. 1.70 + Отпечаток времени позволяет отследить как давно были внесены изменения в репозиторий, 1.71 + а также позволяет отследить степень «свежести» зеркал репозитория. (Перевести отпечаток 1.72 + времени UNIX в дату: <code>date -d@<em>timestamp</em></code>)</x-details></li> 1.73 + <li><tt><a href="file:///var/lib/tazpkg/mirror" target="_blank">mirror</a></tt>: URL текущего 1.74 + используемого зеркала репозитория. 1.75 + <x-details>URL указывает на удаленную папку, содержащую пакеты и файлы базы данных 1.76 + пакетов.</x-details></li> 1.77 + <li><tt><a href="file:///var/lib/tazpkg/mirrors" target="_blank">mirrors</a></tt>: список URL 1.78 + доступных зеркал репозитория. <x-details>Разница между URL в этих двух файлах: вы должны 1.79 + дополнить URL из этого файла строкой <tt>packages/<em>cooking</em>/</tt> (для версии SliTaz, 1.80 + основанной на <tt><em>cooking</em></tt>.</x-details></li> 1.81 + <li><tt><a href="file:///var/lib/tazpkg/packages.list" target="_blank">packages.list</a></tt> 1.82 + (устарел): список имен пакетов с номерами версий, доступных в репозитории.</li> 1.83 + <li><tt><a href="file:///var/lib/tazpkg/packages.desc" target="_blank">packages.desc</a></tt> 1.84 + (устарел): список, содержащий имя пакета, версию, краткое описание, категорию и адрес 1.85 + страницы с последней информацией от разработчиков.</li> 1.86 + <li><tt><a href="file:///var/lib/tazpkg/packages.txt" target="_blank">packages.txt</a></tt> 1.87 + (устарел): список, содержащий имя пакета, версию, краткое описание и размеры пакета 1.88 + <x-details>(первый — трафик, нужный для загрузки пакета, второй — размер на жестком диске, 1.89 + занимаемый установленным пакетом)</x-details>.</li> 1.90 + <li><tt><a href="file:///var/lib/tazpkg/packages.md5" target="_blank">packages.md5</a></tt> 1.91 + (устарел): список, содержащий контрольные суммы MD5 с именами файлов пакетов.</li> 1.92 + <li><tt><a href="file:///var/lib/tazpkg/packages.info" target="_blank">packages.info</a></tt>: 1.93 + список, созданный для замены и расширения вышеперечисленных списков. <x-details>Для каждого 1.94 + пакета, доступного в репозитории он содержит: название пакета, версию, категорию, краткое 1.95 + описание, URL разработчиков, ярлыки, размеры пакета, зависимости и контрольную сумму MD5. 1.96 + Разработка продолжается, поэтому список может быть дополнен прочими полями при 1.97 + необходимости.</x-details></li> 1.98 + <li><tt><a href="file:///var/lib/tazpkg/packages.equiv" target="_blank">packages.equiv</a></tt>: 1.99 + список равнозначных пакетов, доступных в репозитории. <x-details>Формат элемента списка: 1.100 + <tt><em>пакет</em>=<em>правило правило…</em></tt>.<br> 1.101 + Формат правила: <tt><em>альтернатива:новое_имя</em></tt> — если 1.102 + <tt><em>альтернатива</em></tt> установлена, тогда будет установлен пакет под названием 1.103 + <tt><em>новое_имя</em></tt> вместо <tt><em>пакет</em>а</tt>.<br> 1.104 + Второй формат правила, в котором отсутствует часть <tt><em>альтернатива:</em></tt> — в этом 1.105 + случае пакет под названием <tt><em>новое_имя</em></tt> <em>может быть</em> установлен вместо 1.106 + <tt><em>пакет</em>а</tt> (по выбору пользователя).</x-details></li> 1.107 + <li><tt><a href="file:///var/lib/tazpkg/packages.diff" target="_blank">packages.diff</a></tt>: 1.108 + список создается при выполнении команды <tt><a href="#recharge">recharge</a></tt>. 1.109 + <x-details>Список содержит названия новых пакетов с их версиями, которые стали доступны 1.110 + с последним обновлением баз данных.</x-details></li> 1.111 + <li><tt><a href="file:///var/lib/tazpkg/packages.up" target="_blank">packages.up</a></tt>: 1.112 + список создается при выполнении команды <tt><a href="#upgrade">upgrade</a></tt>. 1.113 + <x-details>Список содержит названия пакетов, которые вы сможете обновить.</x-details></li> 1.114 + <li><tt><a href="file:///var/lib/tazpkg/descriptions.txt" 1.115 + target="_blank">descriptions.txt</a></tt>: список «длинных» описаний всех пакетов, доступных 1.116 + в репозитории.</li> 1.117 + <li><tt>packages-desc.<em>язык</em></tt> — необязательный список переведенных кратких описаний 1.118 + пакетов <x-details>(см. пакет tazpkg-desc-ru)</x-details>.</li> 1.119 + <li><tt>descriptions.<em>язык</em>.txt</tt> — необязательный список «длинных» описаний пакетов 1.120 + <x-details>(см. пакет tazpkg-desc-ru)</x-details>.</li> 1.121 + <li><tt>packages.icons</tt> — необязательный список значков пакетов для TazPanel.</li> 1.122 + <li><tt><a href="file:///var/lib/tazpkg/blocked-packages.list" 1.123 + target="_blank">blocked-packages.list</a></tt>: необязательный список пакетов, 1.124 + заблокированных от обновления.</li> 1.125 + <li><tt><a href="file:///var/lib/tazpkg/extra.list" target="_blank">extra.list</a></tt>: список 1.126 + экстра-пакетов <x-details>(несвободные пакеты; свободные пакеты, но не скомпилированные из 1.127 + исходников). Список содержит название пакета, короткое описание, URL разработчиков, 1.128 + категорию, версию, лицензию.</x-details></li> 1.129 + <li><tt>files.list.lzma</tt>: очень большой сжатый список, который содержит названия всех файлов 1.130 + всех пакетов, доступных в репозитории <x-details>(сейчас это — около 5 тыс. пакетов и около 1.131 + 0,7 млн. файлов)</x-details>.</li> 1.132 + <li><tt>files-list.md5</tt>: контрольная сумма MD5 файла <tt>files.list.lzma</tt>.</li> 1.133 + <li><tt><a href="file:///var/lib/tazpkg/installed.info" target="_blank">installed.info</a></tt>: 1.134 + список установленных пакетов, формат которого в точности повторяет формат списка 1.135 + <tt>packages.info</tt>. <x-details>Идея в том, чтобы просто копировать элемент списка из 1.136 + <tt>packages.info</tt> в <tt>installed.info</tt> при установке пакета.</x-details></li> 1.137 + <li><tt><a href="file:///var/lib/tazpkg/installed.md5" target="_blank">installed.md5</a></tt> 1.138 + (устарел): список, содержащий контрольные суммы MD5 с названиями файлов для всех 1.139 + установленных пакетов.</li> 1.140 +</ul> 1.141 + 1.142 +<p>Все устаревшие файлы будут удалены как только мы убедимся, что ни одна программа их более не 1.143 +использует (изменив эти программы при необходимости).</p> 1.144 + 1.145 +<p>В дополнение к общим файлам базы данных пакетов существуют также индивидуальные папки для всех 1.146 +установленных пакетов, которые располагаются по умолчанию в 1.147 +<tt>/var/lib/tazpkg/installed/<em>пакет</em></tt>. Каждая папка может содержать следующие файлы:</p> 1.148 + 1.149 +<ul> 1.150 + <li><tt>receipt</tt> (обязательный) — рецепт пакета</li> 1.151 + <li><tt>files.list</tt> (обязательный) — список файлов пакета</li> 1.152 + <li><tt>md5sum</tt> (обязательный) — контрольные суммы файлов пакета (в настройках может быть 1.153 + определена одна из прочих контрольных сумм: <tt>cksum</tt> (CRC32), <tt>md5sum</tt> (MD5), 1.154 + <tt>sha1sum</tt> (SHA1), <tt>sha256sum</tt> (SHA256), <tt>sha512sum</tt> (SHA512), 1.155 + <tt>sha3sum</tt> (SHA3-512))</li> 1.156 + <li><tt>description.txt</tt> (необязательный) — «длинное» описание</li> 1.157 + <li><tt>modifiers</tt> (необязательный) — список пакетов, которые заменили некоторые из файлов 1.158 + данного пакета</li> 1.159 + <li><tt>volatile.cpio.gz</tt> (необязательный) — архив «официальных» конфигурационных 1.160 + файлов</li> 1.161 +</ul> 1.162 + 1.163 + 1.164 +<h3>Кеш</h3> 1.165 + 1.166 +<p>Кеш пакетов по умолчанию располагается в папке <tt>/var/cache/tazpkg</tt> с подпапками для разных 1.167 +репозиториев. <x-details>Если быть точным, то используется папка 1.168 +<tt>/var/cache/tazpkg/<em>cooking</em>/packages</tt> для версий SliTaz, основанных на 1.169 +<tt><em>cooking</em></tt>.</x-details></p> 1.170 + 1.171 + 1.172 +<h3>Прочие файлы</h3> 1.173 + 1.174 +<p>Файл по умолчанию <tt><a href="file:///var/log/slitaz/tazpkg.log" 1.175 +target="_blank">/var/log/slitaz/tazpkg.log</a></tt> хранит журнал действий TazPkg. 1.176 +<x-details>В журнале сохраняются пять типов действий: установка, удаление, блокирование, 1.177 +разблокирование, переконфигурирование пакетов.</x-details></p> 1.178 + 1.179 +<p>Разделяемая информация MIME, которая позволяет «угадать» файлы пакетов SliTaz, рецепты пакетов и 1.180 +файлы редакций SliTaz (flavor). <x-details>Файл располагаетсяздесь: <tt><a 1.181 +href="file:///usr/share/mime/packages/tazpkg.xml" 1.182 +target="_blank">/usr/share/mime/packages/tazpkg.xml</a></tt>.</x-details></p> 1.183 + 1.184 +<p>Подключаемый модуль для TazPanel (панель администрирования и настройки SliTaz) 1.185 +<tt>/var/www/tazpanel/pkgs.cgi</tt> позволяет управлять пакетами SliTaz при помощи специального 1.186 +<a href="http://127.0.0.1:82/pkgs.cgi" target="_blank">веб-приложения</a>.</p> 1.187 + 1.188 +<p>Документация TazPkg, которую вы читаете, располагается в папке 1.189 +<tt><a href="file:///usr/share/doc/tazpkg" target="_blank">/usr/share/doc/tazpkg</a></tt>.</p> 1.190 + 1.191 + 1.192 + 1.193 + 1.194 +<h2>Команды</h2> 1.195 + 1.196 +<p>Первый параметр <tt>tazpkg</tt> — это команда, за которой следуют обязательные и необязательные 1.197 +параметры как будет описано далее. Опции начинаются с двух дефисов.<!-- , вы можете располагать в любом 1.198 +порядке и в любом месте, даже перед командой. Неизвестные и неподходящие опции игнорируются. 1.199 +Следующие команды идентичны: --></p> 1.200 + 1.201 +<!-- pre> 1.202 +$ tazpkg info nano --root=<em>/mnt/sda6</em> 1.203 +$ tazpkg --root=<em>/mnt/sda6</em> info nano 1.204 +$ tazpkg info --root=<em>/mnt/sda6</em> nano <em>--color</em> 1.205 +</pre --> 1.206 + 1.207 +<!-- p>Вы можете добавить глобальную опцию <tt>--root=…</tt> к любой команде TazPkg. Эта опция позволяет 1.208 +работать с другими установками SliTaz. Опция указывает на корень примонтированной файловой системы 1.209 +другой установки SliTaz. <x-details>Кстати, используя эту опцию, можно установить SliTaz «с нуля» 1.210 +и удаленно обновлять пакеты.</x-details></p --> 1.211 1.212 1.213 <h3>Служебные команды</h3> 1.214 @@ -210,10 +389,10 @@ 1.215 1.216 <pre> 1.217 # tazpkg list 1.218 -# tazpkg -l cat 1.219 +# tazpkg -lc 1.220 # tazpkg -l <em>games</em> 1.221 # tazpkg -l <em>игры</em> 1.222 -# tazpkg -l blocked 1.223 +# tazpkg -lb 1.224 </pre> 1.225 1.226 1.227 @@ -311,8 +490,9 @@ 1.228 <p>Эта команда позволяет устанавливать ранее загруженный пакет с расширением <tt>.tazpkg</tt> 1.229 (<tt>install</tt> или <tt>-i</tt>). См. <tt><a href="#get-install">get-install</a></tt>, если вы 1.230 хотите установить пакет из интернета. Обратите внимание, что вы можете выполнить принудительную 1.231 -установку с параметром <tt>--forced</tt>. Также вы можете указать путь к корню файловой системы, 1.232 -в которую вы хотите установить пакет, с помощью параметра <tt>--root=</tt>.</p> 1.233 +установку с параметром <tt>--forced</tt>. Параметр <tt>--newconf</tt> позволяет переписать все 1.234 +конфигурационные файлы пользователя файлами из пакета. Параметр <tt>--nodeps</tt> позволяет 1.235 +установить только указанный пакет без его зависимостей.</p> 1.236 1.237 <pre> 1.238 # tazpkg install <em>пакет-1.0.tazpkg</em> 1.239 @@ -325,14 +505,13 @@ 1.240 1.241 <p>Загрузить и установить пакет из репозитория в интернете. Эта команда (<tt>get-install</tt> или 1.242 <tt>-gi</tt>) сначала проверяет, существует ли пакет в репозитории и был ли он уже загружен. Для 1.243 -получения списка пакетов в репозитории используйте команду 1.244 -<tt><a href="#list-mirror">list-mirror</a></tt>.</p> 1.245 +получения списка пакетов в репозитории используйте команду <tt><a 1.246 +href="#list-mirror">list-mirror</a></tt>. Обратите внимание, что вы можете выполнить принудительную 1.247 +установку с параметром <tt>--forced</tt>. Параметр <tt>--newconf</tt> позволяет переписать все 1.248 +конфигурационные файлы пользователя файлами из пакета. Параметр <tt>--nodeps</tt> позволяет 1.249 +установить только указанный пакет без его зависимостей.</p> 1.250 1.251 -<p>Команда воспринимает следующие параметры:</p> 1.252 - 1.253 -<p><tt>--forced</tt> позволяет обновить уже установленный пакет.</p> 1.254 - 1.255 -<p><tt>--root=</tt> позволяет указать корень файловой системы, в которой будет установлен пакет.</p> 1.256 +<p>Параметр <tt>--forced</tt> позволяет обновить уже установленный пакет.</p> 1.257 1.258 <pre> 1.259 # tazpkg get-install <em>grub</em> 1.260 @@ -361,8 +540,7 @@ 1.261 были изменены этим пакетом. Эта команда удаляет все файлы, которые устанавливались в составе 1.262 пакета.</p> 1.263 1.264 -<p>Параметр <tt>--root=</tt> позволяет указать корень ФС, в которой будут удаляться пакеты. Параметр 1.265 -<tt>--auto</tt> удаляет и переустанавливает пакеты без вашего подтверждения.</p> 1.266 +<p>Параметр <tt>--auto</tt> удаляет и переустанавливает пакеты без вашего подтверждения.</p> 1.267 1.268 <pre> 1.269 # tazpkg remove <em>bc</em> 1.270 @@ -420,12 +598,17 @@ 1.271 1.272 <h3 id="info">info</h3> 1.273 1.274 -<p>Показать всю информацию по интересующему вас пакету. Информация содержится в рецепте пакета — его 1.275 -версия, категория, разработчик, сайт и все зависимости (см. также Cookutils для получения 1.276 -дополнительной информации по рецептам):</p> 1.277 +<p>Показать всю доступную информацию по интересующему вас пакету. Можно указать название 1.278 +установленного пакета или пакета, который еще не установлен, но доступен в репозитории. Также можно 1.279 +получить информацию о локальном файле пакета, введя абсолютный или относительный путь к этому файлу 1.280 +<tt>.tazpkg</tt>. Информация содержится в базе данных TazPkg и в рецепте пакета — его версия, 1.281 +категория, разработчик, сайт и все зависимости (см. также Cookutils для получения дополнительной 1.282 +информации по рецептам).</p> 1.283 1.284 <pre> 1.285 -# tazpkg info <em>busybox</em> 1.286 +$ tazpkg info <em>busybox</em> 1.287 +$ tazpkg info <em>minitube</em> 1.288 +$ tazpkg info <em>packages/comix-4.0.4.tazpkg</em> 1.289 </pre> 1.290 1.291 1.292 @@ -436,7 +619,7 @@ 1.293 поместиться в стандартном терминале):</p> 1.294 1.295 <pre> 1.296 -# tazpkg desc <em>busybox</em> 1.297 +$ tazpkg desc <em>busybox</em> 1.298 </pre> 1.299 1.300 1.301 @@ -495,6 +678,16 @@ 1.302 1.303 <p>Отображает дерево зависимостей и обратное дерево зависимостей пакета, соответственно.</p> 1.304 1.305 +<p>Для команды <code>depends</code>: опция <tt>--mark</tt> отмечает установленные пакеты плюсом, 1.306 +а не установленные — минусом. Опция <tt>--total</tt> подсчитывает общее количество отображенных 1.307 +пакетов и их суммарный размер. Также, при применении обоих опций будет показано количество и размер 1.308 +пакетов, которые будет нужно установить.</p> 1.309 + 1.310 +<p>Для команды <code>rdepends</code>: без опции <tt>--all</tt> вы получите список обратных 1.311 +зависимостей, полученный только из установленных программ, а с этой опцией — список полученный из 1.312 +всех доступных программ. Опция <tt>--mark</tt> отмечает пакеты так же, как и в команде 1.313 +<code>depends</code>.</p> 1.314 + 1.315 <pre> 1.316 # tazpkg depends <em>mpd</em> 1.317 # tazpkg rdepends <em>mpd</em> 1.318 @@ -596,7 +789,7 @@ 1.319 1.320 <p>Список предложенных пакетов для каждого из ваших установленных пакетов. С параметром 1.321 <tt>--all</tt> будет отображен полный список предложенных пакетов, а без параметра — только список 1.322 -не установленных предложенных пакетов.</p> 1.323 +предложенных пакетов, которые еще не установлены.</p> 1.324 1.325 <pre> 1.326 $ tazpkg list-suggested 1.327 @@ -641,19 +834,18 @@ 1.328 установивших SliTaz на жесткий диск. Обновленные пакеты в режиме Live CD, будут потеряны при 1.329 выключении системы.</p> 1.330 1.331 +<p>Вначале база данных пакетов автоматически обновляется (<tt><a href="#recharge">recharge</a></tt>) 1.332 +для того, чтобы предоставить вам актуальный список пакетов, которые вы сможете обновить.</p> 1.333 + 1.334 <p>Команда без параметров будет работать в интерактивном режиме и спрашивать перед установкой 1.335 -пакетов. Вы можете указать одну или несколько из следующих параметров:</p> 1.336 - 1.337 -<p><tt>-c</tt> или <tt>--check</tt> чтобы только проверить обновления;</p> 1.338 - 1.339 -<p><tt>-r</tt> или <tt>--recharge</tt> чтобы обновить БД и проверить обновления пакетов;</p> 1.340 - 1.341 -<p><tt>-i</tt> или <tt>--install</tt> чтобы проверить обновления и установить их все.</p> 1.342 +пакетов. Вы можете указать один из следующих параметров: <tt>-c</tt> или <tt>--check</tt> чтобы 1.343 +только проверить обновления; <tt>-i</tt> или <tt>--install</tt> чтобы проверить обновления 1.344 +и установить их все.</p> 1.345 1.346 <pre> 1.347 -# tazpkg up 1.348 -# tazpkg up --recharge --install 1.349 -# tazpkg up -r -i 1.350 +# tazpkg upgrade 1.351 +# tazpkg up --check 1.352 +# tazpkg up -i 1.353 </pre> 1.354 1.355 1.356 @@ -702,11 +894,16 @@ 1.357 </pre> 1.358 1.359 1.360 -<h2>МЭЙНТЕЙНЕР</h2> 1.361 +<h2>Мэйнтейнер</h2> 1.362 1.363 <p>Christophe Lincoln <pankso at slitaz.org></p> 1.364 1.365 </div> 1.366 <!-- End content --> 1.367 + 1.368 +<footer> 1.369 + Copyright © 2015 <a href="http://www.slitaz.org/">SliTaz GNU/Linux</a> 1.370 +</footer> 1.371 + 1.372 </body> 1.373 </html>