aboutsummaryrefslogtreecommitdiff
path: root/doc/README.simplaret.pt_BR
blob: 7b1cd583d1af13c0ea3f8eb401f0edfa34f8119f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
simplaret: ferramenta para obten��o de pacotes
----------------------------------------------

O simplaret � a ferramenta do simplepkg utilizada para obter pacotes de reposit�rios locais
ou remotos. Com ele, voc� pode n�o s� baixar pacotes do seu sistema slackware como tamb�m pode
baixar de qualquer vers�o ou arquitetura cujo reposit�rio siga os Mirror Guidelines do slackware,
permitindo que voc� gerencie facilmente todas as suas jaulas e instala��es de slackware,
independentemente da arquitetura ou vers�o que elas utilizem.

Ele foi inspirado no comportamento do swaret mas n�o pretende de modo algum chegar no n�vel de
complexidade deste, mas sim executar a obten��o de pacotes de um modo diferente. Sua finalidade
� apenas baixar pacotes para que os aplicativos do simplepkg possam utiliz�-lo posteriormente.
O simplaret ainda pode ser usado sozinho para procurar e baixar pacotes.

Documenta��o
------------

A documenta��o atualizada do simplaret se encontra em http://slack.sarava.org/node/16

Obtendo e instalando
--------------------

O simplaret acompanha o simplepkg e por isso sua instala��o e configura��o � dada no artigo do simplepkg.
Ele utiliza o mesmo arquivo de configura��o do simplepkg, o /etc/simplepkg/simplepkg.conf e guarda as
defini��es de reposit�rios em /etc/simplepkg/repos.conf.

Organiza��o do reposit�rio
--------------------------

O reposit�rio de armazenamento local do simplaret � definido pelo par�metro STORAGE e � organizado
da seguinte maneira:

  $STORAGE/arch/version/

Pacotes obtidos num reposit�rio que n�o seja oficial da distribui��o ficam em

  $STORAGE/arch/version/repository-name/

Isso quer dizer, por exemplo, que pacotes do slackware 10.2 ficariam em

  $STORAGE/i386/10.2/

e os pacotes obtidos a partir do reposit�rio slamd64 do slack.sarava.org ficaria, por exemplo, em

  $STORAGE/x86_64/10.2/slack.sarava.org/

No arquivo de reposit�rios (/etc/simplepkg/repos.conf), as defini��es de reposit�rio seguem o
seguinte esquema, semelhante ao formato de configura��o do swaret:

  ROOT-i386="http://slack.sarava.org/slackware/"
  ROOT-x86_64="http://ftp.heanet.ie/pub/slamd64/"
  REPOS-i386-10.2="slack.sarava.org%http://slack.sarava.org/packages/slackware/slackware-10.2/"
  REPOS-x86_64-10.2="slack.sarava.org%http://slack.sarava.org/packages/slamd64/slamd64-10.2/"

Reposit�rios definidos como ROOT s�o aqueles que

  - Possuem pacotes da distribui��o oficial ou
  - Est�o organizados por vers�o, de acordo com os mirror guidelines 

J� os reposit�rios definidos como REPOS s�o aqueles que cont�m pacotes para uma vers�o espec�fica e/ou
que s�o n�o-oficiais.

Quando o simplaret busca ou obt�m um pacote, a preced�ncia pelos reposit�rios � dada �s defini��es de
ROOT e em seguinda �s de REPOS. As defini��es REPOS ainda devem possuir, al�m da URL do reposit�rio, um
nome para identific�-lo, sendo que esses dois campos s�o separados por um delimitador.

Baixando as listas de pacotes
-----------------------------

Ap�s configur�-lo, � preciso atualizar a lista de pacotes:

  simplaret --update

Isso atualiza a lista de pacotes da arquitetura definida em DEFAULT_ARCH e da vers�o DEFAULT_VERSION
apenas. Se voc� quiser for�ar a atualiza��o, por exemplo, para a arquitetura x86_64 (slamd64)
e vers�o 10.2, basta

  ARCH=x86_64 VERSION=10.2 simplaret --update

Buscando pacotes
----------------

Para buscar um pacote, esses comandos servem de exemplo:

  simplaret --search coreutils

pacote para o Slack/390,

  ARCH=s390 simplaret --search x11

e para slackware 10.1 com pacotes adicionais em i686,

  ARCH=i686 VERSION=10.1 simplaret --search icecast

Baixando um pacote
------------------

Para baixar um pacote:

  simplaret --get icecast

O simplaret baixa o primeiro pacote na ordem de preced�ncia dos reposit�rios.
Vers�es futuras dever�o conter uma op��o que force a obten��o do pacote de um
reposit�rio espec�fico.

Baixando patches
----------------

Atrav�s do par�metro de configura��o PATCHES_DIR � poss�vel especificar uma pasta
onde os patches de cada distribui��o ser�o armazenados, organizados tamb�m por arquitetura.

Por exemplo, patches do slackware 10.2 ficar�o sempre em

  $PATCHES_DIR/i386/10.2/

Os patches na verdade s�o baixados atrav�s de um "simplaret --get" e armazenados na subpasta
de $STORAGE correspondente e apenas um link simb�lico � mantido em $PATCHES_DIR/$ARCH/$VERSION.

Para baixar os patches, use uma chamada do tipo

  ARCH=arquitetura VERSION=versao simplaret --get-patches

E os patches dessa arquitetura e vers�o ser�o baixados.

Apagando pacotes
----------------

O reposit�rio de pacotes de uma arquitetura e vers�o pode ser apagado com o comando

  simplaret --purge

Mas pra qu� serve isso?
-----------------------

Voc� pode estar se perguntando: 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) 

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,
a tarefa se torna trivial.