Além da obtenção, o simplaret ainda pode fazer a instalação, a remoção ou a atualização dos
pacotes de um sistema e também das demais jaulas existentes numa máquina.
+O simplaret é totalmente não-intrusivo no sistema e roda sobre o pkgtool.
+
Documentação
------------
simplaret install simplepkg
-atualiza o simplepkg caso haja uma nova versão disponível.
+atualiza o simplepkg caso haja uma nova versão disponível nalgum repositório.
+
+Para remover um pacote, digite
+
+ simplaret remove nome-do-pacote
+
+o que na verdade é apenas uma chamada indireta ao removepkg.
+
+O simplaret armazena pacotes baixados de repositórios numa pasta local do sistema, que
+por padrão é /var/simplaret. Conforme você vai baixando e instalando pacotes, essa pasta
+tende a crescer e ocupar muito espaço. Para apagar os pacotes, basta usar o comando
+
+ simplaret purge
+
+Isso apagará apenas os pacotes da arquitetura e versão usadas atualmente. Detalhes de
+como apagar os pacotes de todas a arquiteturas e versões serão dados numa seção seguinte.
+
+Você também pode forçar o simplaret a apagar apenas pacotes antigos. O comando a seguir
+apaga apenas os pacotes baixados a três semanas ou mais (ou seja, os pacotes baixados a
+menos de três semanas continuam armazenados):
+
+ simplaret purge -w 3
-Mais:
+Baixando patches e atualizando o sistema
+----------------------------------------
- - Baixando patches
- - Atualização
- - Removendo pacotes
- - Limpeza do cache
+O simplaret possui, além do básico do gerenciamento de pacotes, duas funcionalidades
+adicionais: a obtenção e a aplicação de patches (pacotes contendo atualizações e
+correções de segurança).
+
+Assumindo que os repositórios contendo patches para sua distribuição do tipo Slackware
+estejam corretamente configurados, o que ocorre com a configuração padrão que acompanha
+o simplepkg e que veremos a seguir como alterá-la, você pode baixar os patches disponíveis
+para o seu sistema com o comando
+
+ simplaret get-patches
+
+Se você quiser não só baixar mas também atualizar seu sistema, isto é, fazer um upgrade com
+os patches disponíveis, use
+
+ simplaret upgrade
Trabalhando com múltiplas arquiteturas e versões
------------------------------------------------
-...
+Até aqui vimos apenas o que é a obrigação de qualquer sistema de gerenciamento de pacotes possuir:
+obtenção de pacotes, instalação, busca e atualização do sistema. O que diferencia o simplaret das
+outras ferramentas, além do esquema de resolução de dependências, é sua capacidade de lidar
+simultaneamente com múltiplas arquiteturas, versões e até instalações de sistemas do tipo Slackware.
+
+O uso dos seguintes comandos só fará sentido à luz da próxima seção, onde trataremos a respeito de
+múltiplas instalações e jaulas num mesmo computador, porém é um pré-requisito para entendê-la.
+
+Supondo que você esteja rodando Slackware (arquitetura i386) mas que queira atualizar a lista de
+pacotes do sistema Slamd64 versão 11.0 (arquitetura x86_64), basta usar o comando
+
+ ARCH=x86_64 VERSION=11.0 simplaret update
+
+Esse comando baixará a lista de pacotes para o Slamd64 sem conflitar de nenhuma forma com a lista
+e os pacotes já baixados para o Slackware. Isso acontece porque o simplaret armazena as informações
+e os pacotes de cada repositório em pastas próprias, organizadas de acordo com a arquitetura e versão.
+
+Passar as variaveis ARCH e VERSION para o simplaret é opcional. Se qualquer uma delas não foi especificada,
+o simplaret utilizará o valor padrão do seu sistema, usualmente obtido do arquivo /etc/slackware-version
+ou então especificada através do arquivo de configuração do simplepkg.
+
+Por exemplo, para pesquisar por um pacote da arquitetura powerpc (distribuição Slackintosh) na versão 11.0,
+basta o comando
+
+ ARCH=powerpc VERSION=11.0 simplaret search nome-do-pacote
+
+Todos os comandos apresentados anteriormente funcionarão dessa maneira, à exceção daqueles que instalam ou
+fazer a atualização de pacotes, já que em geral é destrutivo misturar pacotes de arquiteturas e versões
+diferentes num mesmo sistema.
Trabalhando com múltiplas instalações
-------------------------------------
- - Instalação de pacotes
- - Obtenção de patches
- - Atualização
+A funcionalidade apresentada na seção anterior só faz sentido quando existirem sistemas, jaulas e/ou
+vservers instalados num mesmo computador.
+
+Suponha que você possua uma máquina x86_64 com três sistemas instalados:
+
+ - Slamd64 11.0 na raíz
+ - Slackware 11.0 em /mnt/slackware-1
+ - Slackware 10.2 em /mnt/slackware-2
+
+No caso da instalação de pacotes, da obtenção e aplicação de atualizações, o simplaret suporta a
+variável de ambiente ROOT para especificar qual é a pasta na qual o simplaret deve buscar o sistema.
+
+Para instalar um pacote no Slackware contido em /mnt/slackware-1, basta usar os comandos
+
+ ARCH=i386 VERSION=11.0 simplaret update
+ ROOT=/mnt/slackware-1 simplaret install nome-do-pacote
+
+O primeiro comando apenas atualiza a lista de pacotes e o segundo faz com que o simplaret baixe
+o pacote da arquitetura e versão do sistema presente em /mnt/slackware-1 bem como efetue sua instalação.
+
+Para o caso da instalação em /mnt/slackware-2, o uso é análogo:
+
+ ARCH=i386 VERSION=10.2 simplaret update
+ ROOT=/mnt/slackware-2 simplaret install nome-do-pacote
+
+Existe ainda uma facilidade para que a obtenção e aplicação de atualizações seja feita de forma única,
+através do arquivo /etc/simplepkg/jailist. Esse arquivo serve, além de outros propósitos descritos na
+documentação do simplepkg, para que o simplaret saiba de antemão quais são as instalações de sistema
+do tipo Slackware presentes numa máquina, além da instalação principal na raíz do sistema.
+
+Considerando que a máquina possua as três instalações citadas no início deste tópico, a atualização
+automática das mesmas pode ser feita quando o arquivo /etc/simplepkg/jailist contiver as seguintes
+linhas (sem espaços no início de cada uma):
+
+ /mnt/slackware-1
+ /mnt/slackware-2
+
+O sistema principal, contido na raíz do sistema, não precisa estar listado nesse arquivo. Se todas
+as suas instalações de sistema do tipo Slackware estiverem constando corretamente no /etc/simplepkg/jailist,
+o seguinte comando baixará as atualizações disponíveis para todas elas, incluindo o sistema contido na raíz:
+
+ simplaret get-patches
+
+Analogamente, o seguinte comando baixará e/ou aplicará todas as atualizações disponíveis em todas as
+instalações, incluindo o sistema contido na raíz:
+
+ simplaret upgrade
+
+Desse modo, o gerenciamento de pacotes numa máquina que contenha mais de uma instalação do tipo Slackware
+fica unificada e consequentemente simplificada.
O arquivo repos.conf
--------------------
- - Tipos de repositorio, suas prioridades e ordens de precedência.
+Agora que o comportamento do simplaret foi delineado, é importante descrever o arquivo de definição de
+repositórios, o /etc/simplepkg/repos.conf. Se você não pretende fazer um uso avançado do simplaret,
+provavelmente pode deixar de ler esta e a próxima seção, já que para o uso corriqueiro do simplaret
+você provavelmente não precisará alterar seu repos.conf, a não ser que queira mudar o espelho de download
+dos seus pacotes ou montar um esquema avançado para a escolha e priorização de repositórios.
+
+O arquivo /etc/simplepkg/repos.conf contém uma definição de repositório por linha e a sintaxe de cada
+uma delas é:
+
+ TIPO[-ARQUITETURA][-VERSAO]="nome%URL"
+
+O conteúdo demarcado por colchetes é opcional dependendo do tipo de repositório, como veremos a seguir.
+Os tipos de repositório aceitos pelo simplaret são:
+
+ - PATCHES: definição para repositórios que contenham patches (pacotes de atualização) e cuja lista
+ de arquivos é FILE_LIST e não FILELIST.TXT; exemplo:
+
+ PATCHES-i386-11.0="sarava%http://slack.sarava.org/packages/slackware/slackware-11.0/patches/"
+
+ No caso da definição acima, temos um repositório de patches para a arquitetura i386 (distribuição
+ Slackware), versão 11.0 e o nome dado ao repositório é "sarava".
+
+ Possuir uma definição do tipo PATCHES é opcional para ter acesso às atualizações: a definição
+ de repositório ROOT, que veremos em seguida, já lida com patches: o tipo de repositório PATCHES
+ serve apenas se você quiser utilizar algum repositório não-oficial como fonte de patches
+ prioritária, já que repositório PATCHES são pesquisados pelo simplaret antes de qualquer outro.
+
+ Em resumo, se você não tiver um bom motivo para usar esse tipo de repositório, evite-o.
+
+ - ROOT: são tipos de repositórios cujo conteúdo está dividido por versão. O exemplo tradicional
+ deste caso é o próprio repositório oficial das distribuições:
+
+ ROOT-i386="tds%http://slackware.mirrors.tds.net/pub/slackware/"
+
+ Repositórios ROOT necessitam apenas de uma definição de arquitetura, um nome e uma URL. No caso
+ acima, temos a definição de repositório ROOT de nome "tds", ou seja, não há definição de versão,
+ já que o simplaret considerará que a versão desejada está numa subpasta dessa URL. Ou seja,
+ definições ROOT implicam que as pastas contendo pacotes de cada versão estejam bem separadas,
+ ou seja, pastas como http://slackware.mirrors.tds.net/pub/slackware/slackware-10.2/ e
+ http://slackware.mirrors.tds.net/pub/slackware/slackware-11.0/.
+
+ - REPOS: este tipo de repositório é orientado a arquitetura e versão, como por exemplo
+
+ REPOS-i386-11.0="sarava%http://slack.sarava.org/packages/slackware/slackware-11.0/"
+
+ No caso acima, um repositório de nome "sarava" é definido para a arquitetura i386 e versão
+ 11.0 com a URL http://slack.sarava.org/packages/slackware/slackware-11.0/. Esse tipo de definição
+ é recomendado para repositórios não-oficiais.
+
+ - NOARCH: o último tipo de definição é usado para repositórios cujos pacotes são independentes
+ de arquitetura e versão da distribuição. Como exemplo temos um repositório do Projeto Slack:
+
+ NOARCH="sarava%http://slack.sarava.org/packages/noarch"
+
+Em qualquer tipo de repositório, a URL pode ser do tipo http://, ftp:// ou file:// (para repositórios
+locais).
+
+Como podem haver mais de uma definição de repositório para cada tipo, versão e/ou arquitetura,
+as mesmas são diferenciadas de acordo com o nome. Definições de repositório podem ter nomes idênticos,
+desde que se refiram a tipo de repositório e/ou arquitetura e versão diferentes.
+
+Existe ainda uma prioridade dentre tipos de repositório e ordens de precedência. Numa pesquisa,
+repositórios são pesquisados de acordo com a seguinte ordem:
+
+ - PATCHES tem prioridade mais alta: caso um pacote de uma dada arquitetura e versão não seja
+ encontrado no primeiro repositório PATCHES do repos.conf, o próximo repositório definido na
+ ordem em que ele aparece no arquivo é pesquisado, e assim por diante.
+
+ - Em seguida, pacotes são procurados nas definições ROOT da arquitetura em questão, na ordem
+ em que aparecem no repos.conf.
+
+ - Depois, são os pacotes de repositórios REPOS daquela arquitetura e versão são pesquisados,
+ na ordem em que aparecem no repos.conf.
+
+ - Por fim, repositórios NOARCH são pesquisados, na ordem em que são definidos.
+
+Em resumo, o simplaret tem uma ordem de precedência e execução de repositórios e para busca e obtenção
+de pacotes: pacotes são exibidos de acordo com a ordem e precedência descritas acima. No caso da ontenção
+de pacotes, o primeiro repositório que possuí-lo será utilizado, isto é, caso o pacote não for solicitado
+explicitamente com seu nome de arquivo completo mas sim apenas com seu nome.
+
+No caso da obtenção de patches, por padrão apenas repositórios do tipo PATCHES e ROOT são pesquisados,
+a não ser que isso seja configurado como contrário.
+
+Em repositórios do tipo REPOS e ROOT ainda é possível, através de parâmetros de configuração, explicitar
+a ordem de pastas que são pesquisadas dentro dos repositórios, algo que veremos a seguir e facilita no
+caso do usuário estar interessado em dar prioridade para aplicativos em fase de testes (usualmente
+armazenados na pasta testing/) ou pacotes antigos (pasture).
Parâmetros de configuração do simplepkg.conf
--------------------------------------------
-...
+Nesta seção os parâmetros do arquivo de configuração /etc/simplepkg/simplepkg.conf relevantes ao
+simplaret estão descritos. Para uma lista completa de todos os parâmetros disponíveis, consulte o
+simplepkg.conf contido no pacote do simplepkg. Aqui estão descritos apenas os principais, que são:
+
+ # Default architecture: set this option if you dont want simplepkg
+ # to use the value from /etc/slackware-version
+ # DEFAULT_ARCH="i386"
+
+ # Default version: set this option if you dont want simplepkg;
+ # to use the value from /etc/slackware-version
+ # DEFAULT_VERSION="11.0"
+
+ # Whether mkjail should clean the package cache before installation
+ # to enable it, set to "1" or "yes"
+ SIMPLARET_CLEAN="1"
+
+ # whether mkjail should clean the package cache after the installation;
+ # to enable it, set to "1" or "yes"
+ SIMPLARET_DELETE_DOWN="1"
+
+ # Whether mkjail should issue a simplaret --update before install the jail;
+ # to enable it, set to "1" or "yes"
+ SIMPLARET_UPDATE="1"
+
+ # Wheter try to download from the next repository on failed download.
+ SIMPLARET_DOWNLOAD_FROM_NEXT_REPO="1"
+
+ # Wheter delete also patches when simplaret --purge is called;
+ # to enable it, set to "1" or "yes"
+ SIMPLARET_PURGE_PATCHES="0"
+
+ # Whether delete each package rigth after its installation;
+ # to enable it, set to "1" or "yes"
+ SIMPLARET_DELETE_DURING="0"
+
+ # Delete packages older than N weeks from the cache
+ SIMPLARET_PURGE_WEEKS="3"
+
+ # Where patches are placed
+ PATCHES_DIR="/var/simplaret/patches"
+
+ # Place to store your packages
+ STORAGE="/var/simplaret/packages"
+
+ # Whether to use passive ftp transfers;
+ # to enable it, set to "1" or "yes"
+ PASSIVE_FTP="1"
+
+ # Http retrieval tool;
+ # available parameters are "wget" or "curl"
+ HTTP_TOOL="wget"
+
+ # Ftp retrieval tool;
+ # available parameters are "wget", "curl" or "ncftpget"
+ FTP_TOOL="wget"
+
+ # Set connection timeout in seconds
+ CONNECT_TIMEOUT="20"
+
+ # ROOT repository package priority
+ ROOT_PRIORITY="patches slackware extra testing pasture"
+
+ # REPOS repository package priority
+ REPOS_PRIORITY="patches slackware extra testing pasture"
+
+ # Whether to check package signatures (you should have the repository
+ # maintainer key on your keyring)
+ SIGNATURE_CHECKING="0"
+
+ # Whether simplaret will try to solve dependencies by looking
+ # for packages' slack-required
+ DEPENDENCY_CHECKING="1"
+
+ # Enabling this option (i.e, setting to "1" or "yes"), simplaret will
+ # donwload even # already applied patches, a good option when you plan
+ # to keep local copies of all needed patches for your system
+ DOWNLOAD_EVEN_APPLIED_PATCHES="0"
+
+ # Enabling this option (i.e, setting to "1" or "yes"), simplaret will
+ # look at your standard repositories for new packages; if it find a
+ # package with different version of your current installed package and
+ # also this package isnt in the packages folder, then the new package
+ # is applied; if in doubt, just say no or leave blank. Otherwise set it
+ # either to "yes" or "1" and remember that if enabling this feature can
+ # cause problems if you use more than one REPOS definition for each
+ # ARCH and VERSION. Also, this option can be very slow.
+ CONSIDER_ALL_PACKAGES_AS_PATCHES="0"
+
+ # Enabling this option (i.e, setting to "1" or "yes"), simplaret will
+ # store patches it finds on ROOT repositories on
+ #
+ # $PATCHES_DIR/$ARCH/$VERSION/root-$repository_name.
+ #
+ # By default this option is turned off because it breaks the standard
+ # way to store packages and can cause some confusion, but its an useful
+ # feature if you like to see all patches apart from common packages and/or
+ # stored in the same tree.
+ STORE_ROOT_PATCHES_ON_PATCHES_DIR="0"
Mas para quê serve isso?
------------------------
-Você pode estar se perguntando: quem utilizaria uma ferramenta que baixa pacotes de várias arquiteturas?
+Você pode estar se perguntando: para que mais um gerenciador de pacotes para o Slackware e quem utilizaria
+uma ferramenta que baixa pacotes de várias arquiteturas?
O simplaret foi escrito tendo em mente um ambiente *86 onde várias jaulas de diferentes arquiteturas estão
instaladas. Suponha por exemplo uma máquina x86_64 que possua as seguintes jaulas:
- - slamd64 11.0
- - slackware 11.0
- - slackware 11.0 com pacotes adicionais em i686
- - ucslack (uClibc para i386)
+ - Slamd64 11.0
+ - Slackware 11.0
+ - Slackware 11.0 com pacotes adicionais em i686
+ - ucSlack (uClibc para i386)
O condenado/a em questão que roda todas essas jaulas, pelos mais diversos motivos, pode ter uma grande dor
de cabeça para manter os pacotes em ordem de forma manual. Com o simplaret e eventualmente com o simplepkg,
única arquitetura e/ou versão, o simplaret possui todas as funcionalidades necessárias para facilitar seu
dia-a-dia de gerenciamento de pacotes.
-Mais
-----
+Mais informações
+----------------
+
+O simplaret foi escrito por Silvio Rhatto (rhatto at riseup.net) e é disponibilizado dentro do pacote do
+simplepkg e sob a licença GPL. Para obter o código fonte, digite
+
+ svn checkout svn://slack.sarava.org/simplepkg
- - Obtenção do código fonte
- - Wiki de desenvolvimento
- - Lista de discussão
+O wiki de desenvolvimento: http://slack.sarava.org/wiki/Main/SimplePKG e o endereço da lista de discussão
+utilizada para discussões sobre simplaret, simplepkg ou mesmo distribuições e pacotes do tipo Slackware é
+http://listas.sarava.org/wws/info/slack.
projects / simplepkg.git / commitdiff