1
<!-- -*- mode: sgml; mode: fold -*- -->
2
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
4
<!ENTITY % aptent SYSTEM "apt.ent.es">
10
(c) 2003 Software in the Public Interest
11
Esta traducci�n ha sido realizada por Rub�n Porras Campo <nahoo@inicia.es>
12
Est� basada en la p�gina de manual original:
13
versi�n 1.7 del CVS de
14
/cvs/debian-doc/manpages/english/apt/apt-get.8.sgml
21
<refentrytitle>apt-get</>
25
<!-- Man page title -->
28
<refpurpose>utilidad de manejo de paquetes APT -- interfaz en
36
<arg><option>-hvs</></arg>
37
<arg><option>-o=<replaceable/cadena de configuraci�n/</></arg>
38
<arg><option>-c=<replaceable/fichero/</></arg>
42
<arg>dselect-upgrade</>
43
<arg>install <arg choice="plain" rep="repeat"><replaceable>paquete</replaceable></arg></arg>
44
<arg>remove <arg choice="plain" rep="repeat"><replaceable>paquete</replaceable></arg></arg>
45
<arg>source <arg choice="plain" rep="repeat"><replaceable>paquete</replaceable></arg></arg>
46
<arg>build-dep <arg choice="plain" rep="repeat"><replaceable>paquete</replaceable></arg></arg>
54
<RefSect1><Title>Descripci�n</>
56
<command/apt-get/ es la herramienta en l�nea de �rdenes usada para
57
el manejo de paquetes, tambi�n es la herramienta usada por otras
58
que dependen de la biblioteca APT. Hay varias interfaces disponibles, como
59
dselect(8), aptitude, synaptic, gnome-apt and wajig.
61
Se debe proporcionar una de las siguientes �rdenes a menos que se
62
den las opciones <option/-h/, o <option/--help/.
65
<VarListEntry><Term>update</Term>
67
<literal/update/ se usa para sincronizar el �ndice de
68
paquetes respecto a sus fuentes. Los �ndices de paquetes
69
disponibles se obtienen de los lugares especificados en
70
<filename>/etc/apt/sources.list</>. Por ejemplo, cuando se usa
71
un archivo de Debian, esta orden descarga y analiza los
72
ficheros <filename>Packages.gz</>, de tal forma que la
73
informaci�n acerca de nuevos paquetes pasa a estar
74
disponible. Siempre se debe realizar un <literal/update/
75
antes de un <literal/upgrade/ o un <literal/dist-upgrade/. Se
76
debe tener en cuenta que el indicador de progreso ser�
77
incorrecto, ya que el tama�o de los pr�ximos ficheros con
78
informaci�n sobre paquetes es desconocido hasta el momento de
82
<VarListEntry><Term>upgrade</Term>
84
<literal/upgrade/ se usa para instalar la versi�n m�s
85
nueva de todos los paquetes instalados en el sistema
86
provenientes de alguna de las fuentes listadas en
87
<filename>/etc/apt/sources.list</>. Los paquetes
88
instalados con una nueva versi�n disponible son descargados y
89
actualizados, bajo ninguna circunstancia se desinstalar�n paquetes, o
90
se instalar�n paquetes nuevos. Las nuevas versiones de programas
91
instalados que no puedan ser actualizados sin cambiar el estado de
92
instalaci�n de otros paquetes no se instalar�n, manteni�ndose la
93
versi�n actual. Debe realizarse un <literal/update/ antes para
94
que <command/apt-get/ sepa cuales son las versiones disponibles
98
<VarListEntry><Term>dselect-upgrade</Term>
100
<literal/dselect-upgrade/
101
se usa junto con el tradicional administrador de paquetes de Debian
102
GNU/Linux, &dselect;. <literal/dselect-upgrade/ recoge los
103
cambios hechos al campo de <literal/Status/ de los paquetes
104
disponibles por &dselect;, y realiza las acciones necesarias
105
para que los cambios se lleven a cabo (por ejemplo, borrar
106
paquetes antiguos e instalar las nuevas versiones).
109
<VarListEntry><Term>dist-upgrade</Term>
111
<literal/dist-upgrade/, adem�s de realizar las acciones de
112
<literal/upgrade/, maneja inteligentemente los cambios de
113
dependencias debidos a nuevas versiones de paquetes,
114
<command/apt-get/ tiene un sofisticado sistema de resoluci�n de
115
conflictos, si es necesario tratar� de actualizar los paquetes
116
m�s importantes a costa de los menos importantes. El fichero
117
<filename>/etc/apt/sources.list</> contiene la lista de sitios
118
de los cuales se descargan los ficheros.
119
Tambi�n puede consultar &apt-preferences; si quiere modificar este
120
comportamiento para paquetes individuales.
123
<VarListEntry><Term>install</Term>
125
<literal/install/ instala los paquetes que siguen a la palabra
126
install. Cada nombre de paquete no es el nombre completo del
127
paquete junto con la versi�n de Debian, sino s�lo el nombre del
128
paquete (por ejemplo, en un sistema Debian GNU/Linux, el
129
argumento ser�a libc6, no <literal/libc6_1.9.6-2.deb/). Se obtendr�n e
130
instalar�n todos los paquetes especificados para la
131
instalaci�n, as� como los requeridos por estos. El fichero
132
<filename>/etc/apt/sources.list</> se usa para localizar los
133
paquetes. Si al nombre del paquete se le antepone un gui�n (sin
134
ning�n espacio), el paquete ser� desinstalado en vez de
135
instalado. Similarmente el signo del la suma se puede usar para
136
especificar que un paquete debe de ser instalado. Esta �ltimas
137
caracter�sticas se pueden usar para modificar decisiones
138
tomadas por el sistema de resoluci�n de conflictos de apt-get.
140
Se puede seleccionar una versi�n especifica de un paquete
141
poniendo a continuaci�n del paquete un igual ('=') seguido de
142
la versi�n deseada. Alternativamente se puede seleccionar una
143
distribuci�n especifica poniendo a continuaci�n del nombre del
144
paquete una barra ('/') seguido de la versi�n de la
145
distribuci�n o su nombre en el archivo de Debian (stable,
148
Cualquiera de estos dos m�todos de selecci�n puede instalar una
149
versi�n anterior de los paquetes y debe ser usada con cuidado.
151
Finalmente, &apt-preferences; permite modificar las normas de selecci�n
152
para paquetes individuales.
154
Si ning�n paquete coincide con la expresi�n que se ha dado y la
155
expresi�n contiene un '.', '?' o un '*', entonces se asume que es una
156
expresi�n regular de acuerdo con el est�ndar POSIX, y es aplicada a
157
todos los nombres de paquetes de la base de datos. Cualquier
158
coincidencia se instala (o desinstala). Tenga en cuenta que la
159
comparaci�n se hace en subcadenas, de manera que 'lo.*' es v�lido
160
para 'how-lo' y para 'lowest'. Si este no es el comportamiento deseado
161
se debe anclar la expresi�n regular con un '^' o un '$', o bien crear una
162
expresi�n regular m�s espec�fica.
165
<VarListEntry><Term>remove</Term>
167
<literal/remove/ se comporta del mismo modo que <literal/install/
168
con la diferencia de que desinstala los paquetes en vez de
169
instalarlos. Si un signo m�s precede al nombre del paquete (sin
170
ning�n espacio en blanco entre los dos), el paquete en cuesti�n
171
ser� instalado en vez de eliminado.
174
<VarListEntry><Term>source</Term>
176
<literal/source/ hace que <command/apt-get/ descargue paquetes
177
fuente. APT examinar� los paquetes disponibles para decidir que
178
paquete fuente coger�. Entones descargar� en el directorio
179
actual la versi�n m�s reciente del paquete fuente. Los paquetes
180
fuente se obtienen de sitios distintos a los binarios, estos
181
sitios se especifican mediante l�neas del tipo
182
<literal/deb-src/ en el fichero &sources-list;. Esto puede
183
provocar que la versi�n que descargar� del paquete fuente no
184
coincida con la del paquete binario que tenga instalado o
185
pueda instalar. Si se especifica el argumento --compile
186
entonces el paquete se compilar� usando dpkg-buildpackage para
187
producir un .deb binario, si se especifica el argumento
188
--download-only entonces el paquete fuente no se desempaquetar�.
190
Una versi�n especifica de un paquete fuente puede requerirse
191
poniendo un signo igual ('=') seguido de la versi�n a descargar
192
despu�s del nombre del paquete. Es un mecanismo similar al que
193
se usa con los paquetes binarios. Esto permite seleccionar
194
exactamente el nombre y versi�n del paquete fuente, activando
195
impl�citamente la opci�n <literal/APT::Get::Only-Source/.
198
Dese cuenta que los paquetes fuentes no se tratan como los binarios, s�lo
199
existen en el directorio actual, es parecido a descargar los paquetes tar
200
comprimidos con las fuentes.
203
<VarListEntry><Term>build-dep</Term>
205
<literal/build-dep/ hace que apt-get instale/desinstale paquetes
206
en un intento de satisfacer las dependencias de compilaci�n de
207
un paquete fuente. Por el momento si hay varios paquetes que
208
satisfacen la misma dependencia, apt-get elige uno aleatoriamente.
211
<VarListEntry><Term>check</Term>
213
<literal/check/ es una herramienta de diagn�stico. Actualiza la
214
cach� de paquetes (/var/cache/apt/pkgcache.bin), vuelve a crear
215
un nuevo �rbol de dependencias y busca dependencias imposibles
219
<VarListEntry><Term>clean</Term>
221
<literal/clean/ borra totalmente el repositorio local que
222
contiene los ficheros .deb descargados. Borra todo excepto el
223
fichero de bloqueo de los directorios
224
<filename>&cachedir;/archives/</> y
225
<filename>&cachedir;/archives/partial/</>. Cuando APT se usa como
226
un m�todo de &dselect;, <literal/clean/ se ejecuta
227
autom�ticamente. Si usted no usa dselect es probable que desee
228
ejecutar <literal/apt-get clean/ de vez en cuando para liberar
229
algo de espacio en disco.
232
<VarListEntry><Term>autoclean</Term>
234
Al igual que <literal/clean/, <literal/autoclean/ borra el
235
repositorio local de paquetes descargados. La diferencia reside
236
en que s�lo borrar� aquellos paquetes que ya no pueden ser
237
descargados, o son claramente inservibles. Esto permite
238
mantener la cach� durante largos periodos de tiempo sin que
239
aumente su tama�o sin control. Si la opci�n de configuraci�n
240
<literal/APT::Clean-Installed/ est� desactivada impedir� que se
241
borren paquetes instalados.
246
<RefSect1><Title>Opciones</>
250
<VarListEntry><term><option/-d/</><term><option/--download-only/</>
252
S�lo descarga los ficheros con los paquetes, no los desempaqueta
253
ni los instala. Opci�n de Configuraci�n:
254
<literal/APT::Get::Download-Only/.
257
<VarListEntry><term><option/-f/</><term><option/--fix-broken/</>
259
Intenta arreglar un sistema con dependencias actualmente rotas. Esta
260
opci�n usada conjuntamente con install/remove, puede omitir cualquier
261
paquete para permitir a APT deducir una posible soluci�n. Cualquier paquete
262
especificado debe de corregir totalmente el problema. La opci�n es a
263
veces necesaria cuando se ejecuta apt por primera vez. APT no permite
264
que existan dependencias de paquetes rotas en un sistema. Es posible
265
que la estructura de dependencias de un sistema est� tan deteriorada
266
que requiera una intervenci�n manual (usualmente ejecutar
267
&dselect; o <command/dpkg --remove/ para desinstalar alguno de
268
los paquetes que crean el conflicto). El uso de esta opci�n
269
junto con <option/-m/ puede producir un error en algunas
270
situaciones. Opci�n de Configuraci�n: <literal/APT::Get::Fix-Broken/.
273
<VarListEntry><term><option/-m/</><term><option/--ignore-missing/</>
274
<term><option/--fix-missing/</>
276
No tiene en cuenta los paquetes que no se hayan podido descargar o que
277
despu�s de la descarga se encuentren da�ados, estos paquetes se tratan
278
como no modificables y se contin�a con el resto. Usar esta opci�n junto
279
con <option/-f/ puede producir un error en algunas situaciones. Si un
280
paquete se selecciona para su normal instalaci�n (particularmente si
281
se hace mediante la l�nea de �rdenes) y no puede ser descargado,
282
ser� tratado como no modificable. Opci�n de Configuraci�n:
283
<literal/APT::Get::Fix-Missing/.
286
<VarListEntry><term><option/--no-download/</>
288
Deshabilita la descarga de paquetes. Usada junto con
289
<option/--ignore-missing/ es la mejor manera de forzar a APT a usar
290
solo los .debs que ya se han descargado con anterioridad.
291
Opci�n de Configuraci�n: <literal/APT::Get::Download/.
294
<VarListEntry><term><option/-q/</><term><option/--quiet/</>
296
Silencioso. Produce una salida adecuada para un registro,
297
omitiendo los indicadores de progreso. Si se especifican m�s q's
298
(hasta un m�ximo de 2) se conseguir� una salida m�s
299
silenciosa. Tambi�n es posible usar <option/-q=#/ para
300
seleccionar el nivel de silenciosidad, no teniendo en cuenta el
301
fichero de configuraci�n. Dese cuenta que un nivel silencioso de
302
2 implica <option/-y/, por lo tanto nunca se deber� usar -qq sin
303
a�adir un modificador para que no realice ninguna acci�n como
304
-d, --print-uris o -s para evitar que APT realice algo que usted
305
no espera. Opci�n de Configuraci�n: <literal/quiet/.
308
<VarListEntry><term><option/-s/</>
309
<term><option/--simulate/</>
310
<term><option/--just-print/</>
311
<term><option/--dry-run/</>
312
<term><option/--recon/</>
313
<term><option/--no-act/</>
315
No realiza ninguna acci�n; simula lo que hubiese ocurrido, pero sin
316
hacer cambios reales en el sistema. Opci�n de Configuraci�n:
317
<literal/APT::Get::Simulate/.
319
La simulaci�n muestra por pantalla una serie de l�neas, cada una de
320
las cuales representa una operaci�n de dpkg, configurar (Conf),
321
desinstalar (Remv), o desempaquetar (Inst). Un par de corchetes
322
indican paquetes con dependencias rotas, si no hay nada entre ellos
323
significa que no hay ning�n problema (poco probable).
326
<VarListEntry><term><option/-y/</><term><option/--yes/</>
327
<term><option/--assume-yes/</>
329
Asume una respuesta afirmativa a todas las preguntas, de esta forma
330
apt-get se ejecuta sin necesidad de intervenci�n posterior para tomar
331
decisiones. <literal/apt-get/ terminar� sin hacer nada si se
332
produjese una situaci�n no deseada, como cambiar un paquete
333
puesto en hold (un paquete puesto en hold es un paquete que no
334
debe de ser modificado) o desinstalar un paquete esencial.
335
Opci�n de Configuraci�n: <literal/APT::Get::Assume-Yes/.
338
<VarListEntry><term><option/-u/</><term><option/--show-upgraded/</>
340
Muestra los paquetes que se van a actualizar. Opci�n de Configuraci�n:
341
<literal/APT::Get::Show-Upgraded/.
344
<VarListEntry><term><option/-V/</><term><option/--verbose-versions/</>
346
Muestra la versi�n completa para los paquetes actualizados e instalados.
347
Opci�n de configuraci�n: <literal/APT::Get::Show-Versions/.
350
<VarListEntry><term><option/-b/</><term><option/--compile/</>
351
<term><option/--build/</>
353
Descarga las fuentes y luego las compila.
354
Opci�n de Configuraci�n: <literal/APT::Get::Compile/.
357
<VarListEntry><term><option/--ignore-hold/</>
359
No respeta los paquetes retenidos. Esto puede ser interesante junto con
360
<literal/dist-upgrade/ para no tener en cuenta un gran n�mero de
361
paquetes en hold. Opci�n de Configuraci�n: <literal/APT::Ignore-Hold/.
364
<VarListEntry><term><option/--no-upgrade/</>
366
No actualiza los paquetes. Cuando se usa juntamente con
367
<literal/install/, <literal/no-upgrade/ evita que se actualicen los
368
paquetes listados en la l�nea de �rdenes si ya est�n previamente
369
instalados. Opci�n de Configuraci�n: <literal/APT::Get::Upgrade/.
372
<VarListEntry><term><option/--force-yes/</>
374
Supone una respuesta afirmativa a todas las preguntas. �sta es una
375
opci�n peligrosa que har� que apt-get contin�e incluso si va a
376
realizar algo potencialmente peligros. No se debe usar excepto
377
en situaciones muy especiales. �<literal/force-yes/ puede
378
destruir su sistema! Opci�n de Configuraci�n:
379
<literal/APT::Get::force-yes/.
382
<VarListEntry><term><option/--print-uris/</>
384
Muestra las URIs de los ficheros a instalar en vez de
385
descargarlos. Cada URI tiene la direcci�n de donde se obtendr�
386
el paquete, el fichero de destino, su tama�o y la suma de
387
control md5 esperada. Dese cuenta que el nombre de fichero no
388
siempre coincide con el nombre de fichero en el sitio
389
remoto. Esto tambi�n funciona con las ordenes <literal/source/ y
390
<literal/update/. Cuando se usa con la orden <literal/update/,
391
no se incluyen ni la suma de control MD5 ni el tama�o, y es
392
tarea del usuario descomprimir cualquier fichero comprimido.
393
Opci�n de Configuraci�n: <literal/APT::Get::Print-URIs/.
396
<VarListEntry><term><option/--purge/</>
398
Borra los archivos de configuraci�n de todos los paquetes que sean
399
desinstalados. Se mostrar� un asterisco '*' a continuaci�n de los paquetes
400
que se encuentren en esta situaci�n. Opci�n de Configuraci�n:
401
<literal/APT::Get::Purge/.
404
<VarListEntry><term><option/--reinstall/</>
406
Reinstala los paquetes ya instalados, incluso si son la �ltima versi�n
407
disponible del paquete. Opci�n de Configuraci�n:
408
<literal/APT::Get::ReInstall/.
411
<VarListEntry><term><option/--list-cleanup/</>
413
Esta opci�n est� activada por omisi�n, si quiere desactivarla use
414
<literal/--no-list-cleanup/. Cuando est� activada
415
<command/apt-get/ administra autom�ticamente los contenidos de
416
<filename>&statedir;/lists</> para asegurarse de que se borran
417
los ficheros obsoletos. La �nica raz�n para desactivarla es un
418
cambio frecuente en la lista de repositorios que usa
419
apt-get. Opci�n de Configuraci�n: <literal/APT::Get::List-Cleanup/.
422
<VarListEntry><term><option/-t/</>
423
<term><option/--target-release/</>
424
<term><option/--default-release/</>
426
Esta opci�n permite tener un control sobre la versi�n de la
427
distribuci�n desde la cual se instalan los paquetes de manera
428
sencilla, creando un pin de 990 usando la cadena de caracteres
429
proporcionada que hace referencia a la distribuci�n. Algunos ejemplos
430
comunes pueden ser <option>-t '2.1*'</> o <option>-t unstable</>.
431
Opci�n de configuraci�n: <literal/APT::Default-Release/.
432
Vea adem�s la p�gina del manual de &apt-preferences;.
435
<VarListEntry><term><option/--trivial-only/</>
437
S�lo realiza acciones consideradas triviales. Esta opci�n est�
438
relacionada con <option/--assume-yes/, donde <option/--assume-yes/
439
responder� afirmativamente a cualquier pregunta,
440
<option/--trivial-only/ responder� negativamente.
441
Opci�n de configuraci�n: <literal/APT::Get::Trivial-Only/.
444
<VarListEntry><term><option/--no-remove/</>
446
Si alg�n paquete va a ser desinstalado apt-get termina inmediatamente.
447
Opci�n de Configuraci�n: <literal/APT::Get::Remove/
450
<VarListEntry><term><option/--only-source/</>
452
S�lo tiene sentido para la orden <literal/source/. Indica que los
453
nombres de paquetes fuente dados no deben ser tratados a
454
trav�s de la tabla de binarios. Esto significa que si se especifica esta
455
opci�n, la orden <literal/source/ s�lo aceptar� como argumentos nombres de
456
paquetes fuente, en vez de aceptar nombres de paquetes binarios y luego
457
buscar el nombre del paquete fuente correspondiente.
458
Opci�n de Configuraci�n: <literal/APT::Get::Only-Source/
461
<VarListEntry><term><option/--diff-only/</><term><option/--tar-only/</>
463
Descarga s�lo el fichero diff o tar del archivo fuente.
464
Opciones de Configuraci�n: <literal/APT::Get::Diff-Only/ y
465
<literal/APT::Get::Tar-Only/
468
<VarListEntry><term><option/--arch-only/</>
470
Procesa s�lo las dependencias de construcci�n dependientes de la
471
arquitectura. Opci�n de configuraci�n: <literal/APT::Get::Arch-Only/
479
<RefSect1><Title>Ficheros</>
481
<VarListEntry><term><filename>/etc/apt/sources.list</></term>
483
Fichero que contiene los sitios de donde se obtienen los paquetes.
484
Opci�n de Configuraci�n: <literal/Dir::Etc::SourceList/.
487
<VarListEntry><term><filename>/etc/apt/apt.conf</></term>
489
Fichero de configuraci�n de APT.
490
Opci�n de Configuraci�n: <literal/Dir::Etc::Main/.
493
<VarListEntry><term><filename>/etc/apt/apt.conf.d/</></term>
495
Directorio con fragmentos de ficheros de configuraci�n APT.
496
Opci�n de Configuraci�n: <literal/Dir::Etc::Parts/.
499
<VarListEntry><term><filename>/etc/apt/preferences</></term>
501
Fichero de configuraci�n que contiene preferencias sobre versiones de
502
paquetes, por ejemplo, puede especificar que un cierto paquete se descargue
503
de un sitio diferente, o de una distribuci�n con una versi�n diferente.
504
Opci�n de Configuraci�n: <literal/Dir::Etc::Preferences/.
507
<VarListEntry><term><filename>&cachedir;/archives/</></term>
509
Directorio donde se guardan los paquetes obtenidos.
510
Opci�n de Configuraci�n: <literal/Dir::Cache::Archives/.
513
<VarListEntry><term><filename>&cachedir;/archives/partial/</></term>
515
Directorio donde se guardan los ficheros en tr�nsito.
516
Opci�n de Configuraci�n: <literal/Dir::Cache::Archives/ (Implica partial).
519
<VarListEntry><term><filename>&statedir;/lists/</></term>
521
Directorio donde se almacena informaci�n de estado por cada
522
sitio especificado en &sources-list;
523
Opci�n de Configuraci�n: <literal/Dir::State::Lists/.
526
<VarListEntry><term><filename>&statedir;/lists/partial/</></term>
528
Directorio de almacenamiento para la informaci�n de estado en tr�nsito.
529
Opci�n de Configuraci�n: <literal/Dir::State::Lists/ (Implica partial).
534
<RefSect1><Title>Vea adem�s</>
536
&apt-cache;, &apt-cdrom;, &dpkg;, &dselect;, &sources-list;, &apt-conf;,
537
&apt-config;, la gu�a de usuario de APT en &docdir;, &apt-preferences;, el
541
<RefSect1><Title>Diagn�sticos</>
543
<command/apt-get/ devuelve cero en operaciones satisfactorias, 100 en caso
551
<title>TRADUCTOR</title>
553
Traducci�n de Rub�n Porras Campo
554
<debian-l10n-spanish@lists.debian.org>
added
removed
doc/es/apt-get.es.8.sgml
