aboutsummaryrefslogtreecommitdiff
path: root/es_ES.ISO8859-1/books/handbook/ports/chapter.sgml
blob: ca108780ec553af0a6c1a9917059b887b5991cd6 (plain) (blame)
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
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
<!--
     The FreeBSD Documentation Project

     The FreeBSD Spanish Documentation Project
     %SOURCE% en_US.ISO8859-1/books/handbook/ports/chapter.sgml
     %SRCID%    1.284

     $FreeBSD$
     $FreeBSDes: doc/es_ES.ISO8859-1/books/handbook/ports/chapter.sgml,v 1.2 2004/10/08 21:26:03 jesusr Exp $
-->


<chapter id="ports">
  <title>Instalaci&oacute;n de aplicaciones: &laquo;packages&raquo; y ports</title>

  <sect1 id="ports-synopsis">
    <title>Sinopsis</title>

    <indexterm><primary>ports</primary></indexterm>
    <indexterm><primary>packages</primary></indexterm>

    <para>&os; viene con una excelente colecci&oacute;n de herramientas
      de sistema como parte del sistema base.  A pesar de esto, existe gran 
      cantidad de cosas que uno requiere hacer para poner las cosas realmente en
      marcha, para lo cual se necesita instalar software adicional de 
      terceros. 
      &os; ofrece dos tecnolog&iacute;as complementarias para instalar 
      software de terceros en nuestro sistema: la Colecci&oacute;n de Ports de 
      &os; y &laquo;packages&raquo;(paquetes)  binarios.  Cualquiera de los dos
      sistemas puede usarse para instalar las versiones m&aacute;s recientes,
      de forma local o directamente desde la red.</para>

    <para>Despu&eacute;s de leer este cap&iacute;tulo usted 
      sabr&aacute;:</para>

    <itemizedlist>
      <listitem>
	<para>C&oacute;mo instalar packages binarios de software
	de terceros.</para>
      </listitem>
      <listitem>
	<para>C&oacute;mo compilar software de terceros desde la
	  Colecci&oacute;n de Ports.</para>
      </listitem>
      <listitem>
	<para>C&oacute;mo eliminar packages o ports instalados
	  previamente.</para>
      </listitem>
      <listitem>
        <para>C&oacute;mo sobreescribir los valores por omisi&oacute;n
	  que utiliza la colecci&oacute;n de ports.</para>
      </listitem>
      <listitem>
        <para>C&oacute;mo encontrar la aplicaci&oacute;n adecuada.</para>
      </listitem>
      <listitem>
        <para>C&oacute;mo actualizar aplicaciones.</para>
      </listitem>

    </itemizedlist>
  </sect1>

  <sect1 id="ports-overview">
    <title>Aproximaci&oacute;n a la instalaci&oacute;n de software</title>

    <para>Si ha usado un sistema &unix; con anterioridad sabr&aacute; que el
      procedimiento t&iacute;pico para instalar software de terceros es algo
      similar a esto:</para>

    <procedure>
      <step>
	<para>Descargar el software, que puede distribuirse en formato de
	  c&oacute;digo fuente o binario.</para>
      </step>

      <step>
	<para>Desempaquetar el software de su formato de distribuci&oacute;n
	  (normalmente en un &laquo;tarball&raquo; comprimido con &man.compress.1;,
	  &man.gzip.1; o &man.bzip2.1;).</para>
      </step>

      <step>
	<para>Consultar la documentaci&oacute;n (quiz&aacute;s un fichero
	  <filename>INSTALL</filename> o
	  <filename>README</filename>, o los ficheros del subdirectorio
	  <filename>doc/</filename>) para ver como instalar el software.</para>
      </step>

      <step>
	<para>Si el software se distribuye como fuente, compilarlo.  Esto
	  puede requerir que editemos el fichero <filename>Makefile</filename>
	  o que ejecutemos el &laquo;script&raquo;
	  <command>configure</command>, entre otras cosas.</para>
      </step>

      <step>
	<para>Instalar y probar el software.</para>
      </step>
    </procedure>

    <para>Y esto solamente si todo marcha bien.  Si est&aacute; instalando un
      software que no ha sido portado espec&iacute;ficamente para &os;, puede
      que sea necesario editar el c&oacute;digo para que funcione
      correctamente.
      </para>

    <para>Si lo desea puede continuar instalando software de la forma
      &laquo;tradicional&raquo; en &os;, aunque &os; dispone de
      dos tecnolog&iacute;s que le pueden ahorrar gran cantidad de tiempo y
      esfuerzo: los packages y los ports.  En el momento de escribir esto
      existen m&aacute;s de &os.numports; aplicaciones de terceros.</para>

    <para>En cualquier aplicaci&oacute;n el paquete de &os;
      es un solo fichero que tiene que descargar.  Los paquetes contienen
      copia de los programas binarios precompilados de la aplicaci&oacute;n,
      as&iacute; como cualquier fichero de configuraci&oacute;n o
      documentaci&oacute;n.  Los paquetes descargados se pueden
      manipular con las herramientas de gesti&oacute;n de paquetes de &os;:
      &man.pkg.add.1;, &man.pkg.delete.1;,
      &man.pkg.info.1;, etc.  Instalar una aplicaci&oacute;n nueva puede
      realizarse con una sola orden.</para>

    <para>Un port de &os; es una colecci&oacute;n de ficheros
      dise&ntilde;ada para automatizar el proceso de
      compilaci&oacute;n desde el c&oacute;digo fuente.</para>

    <para>Recuerde que existen ciertos pasos que deber&aacute; llevar a cabo
      para compilar un programa por usted mismo (descargar,
      desempaquetar, parchear, compilar e instalar).  Los ficheros que
      conforman un port permiten que el sistema se encargue de todo esto.  
      Usted ejecuta un conjunto simple de &oacute;rdenes
      y el c&oacute;digo fuente se descarga, desempaqueta, parchea,
      compila e instala.</para>

    <para>De hecho el sistema de ports tambi&eacute;n se puede usar para crear
      paquetes que posteriormente se pueden manipular con
      <command>pkg_add</command> y las
      dem&aacute;s utilidades de gesti&oacute;n de packages que veremos en
      breve.</para>

    <para>Tanto el sistema de ports como el de paquetes entienden las
      <emphasis>dependencias</emphasis>.  Suponga que desea instalar una
      aplicaci&oacute;n que depende de que una biblioteca
      espec&iacute;fica est&eacute; instalada.  Tanto la biblioteca como la
      aplicaci&oacute;n existen en &os; como paquete o port.  Si utiliza
      <command>pkg_add</command> o el sistema de ports para instalar
      la aplicaci&oacute;n ambos notar&aacute;n que la biblioteca no
      est&aacute; instalada y proceder&aacute;n a instalarla antes que
      nada.</para>

    <para>Dado que ambas tecnolog&iacute;s son similares quiz&aacute;s se
      pregunte por qu&eacute; &os; se toma la molest&iacute;a de contar con
      ambas.  Los Packages y los Ports tienen sus propias ventajas,
      as&iacute; que cu&aacute;l utilizar depender&aacute; de su
      elecci&oacute;n en cada momento.</para>

    <itemizedlist>
      <title>Ventajas de los Paquetes</title>
      
      <listitem>
	<para>El fichero tarball de un package es normalmente m&aacute;s
	  peque&ntilde;o que el tarball con el c&oacute;digo fuente de
	  la aplicaci&oacute;n.</para>
      </listitem>

      <listitem>
	<para>Los paquetes no requieren compilaci&oacute;n.  
	  En el caso de aplicaciones grandes, como
	  <application>Mozilla</application>,
	  <application>KDE</application>, o
	  <application>GNOME</application> este detalle puede ser importante,
	  especialmente si usa un equipo lento.</para>
      </listitem>

      <listitem>
	<para>Los paquetes no requieren que comprenda el proceso que envuelve
	  el compilar software bajo &os;.</para>
      </listitem>
    </itemizedlist>

    <itemizedlist>
      <title>Ventajas de los Ports</title>
      
      <listitem>
	<para>Normalmente los paquetes se compilan con opciones conservadoras,
	  en virtud del gran n&uacute;mero de equipos donde se
	  instalar&aacute;n.  Al instalar como port puede usted editar las
	  preferencias para (por ejemplo) generar c&oacute;digo
	  espec&iacute;fico para un procesador
	  Pentium IV o Athlon.</para> 
      </listitem>

      <listitem>
	<para>Algunas aplicaciones tienen opciones sobre lo que pueden y lo
	  que no pueden hacer.  Por ejemplo 
	  <application>Apache</application> se puede configurar con
	  una gran variedad de opciones.  Al compilarlo desde los
	  ports usted no tiene por que aceptar las opciones
	  predefinidas, puede seleccionar que opciones desea.</para>

	<para>En algunos casos existen varios paquetes para la misma  
	  aplicaci&oacute;n con diferentes opciones.  Por ejemplo,
	  <application>Ghostscript</application> est&aacute; disponible
	  como paquete
	  <filename>ghostscript</filename> y como paquete
	  <filename>ghostscript-nox11</filename>, dependiendo de si usted
	  cuenta o no con servidor X11.  En este caso decidir puede ser
	  sencillo e incluso pueden facilitarse packages con ambas opciones,
	  pero elegir se puede volver un problema si hay m&aacute;s de
	  una o dos opciones de compilaci&oacute;n.</para>
      </listitem>

      <listitem>
	<para>Las condiciones de la licencia de algunas aplicaciones
	  prohiben la distribuci&oacute;n de binarios.  Solo permiten la
	  distribuci&oacute;n del c&oacute;digo fuente.</para>
      </listitem>

      <listitem>
	<para>Existe gente que no conf&iacute;a en los binarios.  Al
	  menos puede usted (en teor&iacute;a) revisar el c&oacute;digo fuente
	  y localizar problemas potenciales.</para>
      </listitem>

      <listitem>
	<para>Si tiene parches locales necesitar&aacute; el c&oacute;digo
	  fuente para poder aplicarlos.</para>
      </listitem>

      <listitem>
	<para>Hay gente a la que le gusta tener el c&oacute;digo fuente para
	  poder leerlo en ratos de ocio, modificarlo, tomar partes prestadas
	  (cuando la licencia lo permite, claro est&aacute;), etc.</para>
      </listitem>
    </itemizedlist>

    <para>Para tener constancia de los ports actualizados, suscr&iacute;base
      a la &a.ports; y a la &a.ports-bugs;.</para>

    <warning>
      <para>&nbsp;Antes de instalar cualquier aplicaci&oacute;n
        consulte <ulink url="http://vuxml.freebsd.org"></ulink> para
        comprobar los posibles problemas de seguridad relacionados con
	ella.</para>

      <para>Tambi&eacute;n puede instalar <filename
        role="package">security/portaudit</filename> que autom&aacute;ticamente
        comprobar&aacute; las vulnerabilidades conocidas de todas las
        aplicaciones instaladas; tambi&eacute;n lo comprobar&aacute; antes de
        compilar cualquier port.  Mientras tanto, puede usar
        <command>portaudit -F -a</command> despu&eacute;s de instalar
        algunos packages.</para>
    </warning>

    <para>El resto de este cap&iacute;tulo le explicar&aacute; c&oacute;mo
      usar los ports y los packages para instalar software de terceros en
      &os;.</para>
  </sect1>

  <sect1 id="ports-finding-applications">
    <title>C&oacute;mo encontrar aplicaciones</title>

    <para>Antes de poder instalar cualquier software debe saber qu&eacute;
      es lo que quiere instalar y c&oacute;mo se llama la
      aplicaci&oacute;n.</para>

    <para>La lista de software disponible para &os; crece constantemente.  
      Afortunadamente existen varias formas de localizar lo que busca:</para>

    <itemizedlist>
      <listitem>
	<para>El sitio web de &os; mantiene una lista (actualizada y que
	  admite b&uacute;squedas) de todas las
	  aplicaciones disponibles para &os; en la direcci&oacute;n
	  <ulink url="http://www.freebsd.org/ports/index.html">http://www.FreeBSD.org/ports/
	  </ulink>.  Esta base esta dividida en categor&iacute;as, y puede
	  buscar por nombre (si lo sabe) o bien listar las aplicaciones
	  disponibles en cierta categor&iacute;a.</para>
      </listitem>

      <indexterm><primary>FreshPorts</primary></indexterm>

      <listitem>
	<para>Dan Langille mantiene FreshPorts en
	  <ulink url="http://www.FreshPorts.org/"></ulink>.  
	  FreshPorts verifica los cambios en las aplicaciones del &aacute;rbol
	  de ports, y le permite &laquo;seguir&raquo; uno o m&aacute;s
	  ports, sobre los que le enviar&aacute;n un correo cada vez
	  que se actualicen.</para>
      </listitem>

      <indexterm><primary>FreshMeat</primary></indexterm>

      <listitem>
	<para>Si no conoce el nombre de la aplicaci&oacute;n que desea
	  pruebe a usar un sitio como FreshMeat (<ulink 
	  url="http://www.freshmeat.net/">http://www.freshmeat.net/</ulink>)
	  para encontrar una aplicaci&oacute;n; despu&eacute;s consulte
	  el sitio web de &os; para ver si la aplicaci&oacute;n ha sido
	  portada.</para>
      </listitem>

      <listitem>
	<para>Si sabe el nombre exacto del port y solo necesita saber
          en qu&eacute; categoria est&aacute; puede usar
          &man.whereis.1;.  Simplemente escriba <command>whereis
          <replaceable>fichero</replaceable></command>, donde
          <replaceable>fichero</replaceable> es el programa que quiera
          instalar.  Si est&aacute; en su sistema, le dir&aacute; d&oacute;nde
          est&aacute;:</para>

      <screen>&prompt.root; <userinput>whereis lsof</userinput>
lsof: /usr/ports/sysutils/lsof</screen>

      <para>Esto nos dice que <command>lsof</command> (una utilidad de
	sistema) est&aacute; en el directorio
	<filename>/usr/ports/sysutils/lsof</filename>.</para></listitem>

      <listitem>
	<para>Otra forma de encontrar un port en particular es usando
        el mecanismo de b&uacute;squeda integrado en la colecci&oacute;n de
        ports.  Para poder usar esta opci&oacute;n de b&uacute;squeda
        debe estar en el directorio <filename>/usr/ports</filename>.  Una
        vez en ese directorio ejecute <command>make search
        name=<replaceable>nombre-del-programa</replaceable></command>, donde
        <replaceable>nombre-del-programa</replaceable> es el nombre
        del programa que desea encontrar.  Por ejemplo, si busca
        <command>lsof</command>:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports</userinput>
&prompt.root; <userinput>make search name=lsof</userinput>
Port:   lsof-4.56.4
Path:   /usr/ports/sysutils/lsof
Info:   Lists information about open files (similar to fstat(1))
Maint:  obrien@FreeBSD.org
Index:  sysutils
B-deps: 
R-deps: </screen>

      <para>Debe prestar especial atenci&oacute;n a la l&iacute;nea
        &laquo;Path:&raquo;de la salida, porque es la que indica
        d&oacute;nde puede encontrar el port.  El resto de informaci&oacute;n
        no se necesita para instalar el port.</para>

      <para>Si quiere hacer una b&uacute,squeda m&aacute;s a fondo
       utilice <command>make
       search key=<replaceable>cadena</replaceable></command> donde
       <replaceable>cadena</replaceable> es el t&eacute;rmino que busca.  
       Podr&aacute; buscar nombres de ports, comentarios,
       descripciones y dependencias; tambi&eacute;n se puede usar
       para encontrar ports que tengan relaci&oacute;n con
       alg&uacute;n tema en particular si no conoce el nombre del
       programa que busca.</para>

      <para>En ambos casos la cadena de b&uacute;squeda no distingue entre
       may&uacute;sculas y min&uacute;sculas.  Buscar &laquo;LSOF&raquo;
       dar&aacute; los mismos resultados que buscar
       &laquo;lsof&raquo;.</para>
      </listitem>

    </itemizedlist>

  </sect1>

  <sect1 id="packages-using">
    <sect1info>    
      <authorgroup>
        <author>
          <firstname>Chern</firstname>
	  <surname>Lee</surname>
	  <contrib>Texto de </contrib>
        </author>
      </authorgroup>
    <!-- 30 Mar 2001 -->
    </sect1info>

    <title>Uso del sistema de packages</title>

    <sect2>
      <title>Instalar un package</title>
      <indexterm>
        <primary>packages</primary>
        <secondary>installing</secondary>
      </indexterm>
    
      <indexterm>
        <primary><command>pkg_add</command></primary>
      </indexterm>
      <para>Puede usar &man.pkg.add.1; para instalar un
      package de &os; desde un fichero local o desde
      un servidor remoto v&iacute;a red.</para>

      <example>
        <title>Descarga de un paquete manualmente e instalaci&oacute;n en
	  nuestro sistema</title>

        <screen>&prompt.root; <userinput>ftp -a <replaceable>ftp2.FreeBSD.org</replaceable></userinput>
Connected to ftp2.FreeBSD.org.
220 ftp2.FreeBSD.org FTP server (Version 6.00LS) ready.
331 Guest login ok, send your email address as password.
230-
230-     This machine is in Vienna, VA, USA, hosted by Verio.
230-         Questions? E-mail freebsd@vienna.verio.net.
230-
230-
230 Guest login ok, access restrictions apply.
Remote system type is UNIX.
Using binary mode to transfer files.
<prompt>ftp></prompt> <userinput>cd /pub/FreeBSD/ports/packages/sysutils/</userinput>
250 CWD command successful.
<prompt>ftp></prompt> <userinput>get lsof-4.56.4.tgz</userinput>
local: lsof-4.56.4.tgz remote: lsof-4.56.4.tgz
200 PORT command successful.
150 Opening BINARY mode data connection for 'lsof-4.56.4.tgz' (92375 bytes).
100% |**************************************************| 92375       00:00 ETA
226 Transfer complete.
92375 bytes received in 5.60 seconds (16.11 KB/s)
<prompt>ftp></prompt> <userinput>exit</userinput>
&prompt.root; <userinput>pkg_add <replaceable>lsof-4.56.4.tgz</replaceable></userinput></screen>
      </example>

      <para>Si no tiene una fuente local de packages (por ejemplo
        un CDROM de &os;) probablemente la mejor
        opci&oacute;n sea utilizar el argumento <option>-r</option> de
        &man.pkg.add.1;, que har&aacute; que determine
        autom&aacute;ticamente el formato del objeto correcto, para
        posteriormente descargarlo e instalarlo desde un FTP.</para>

      <indexterm>
        <primary><command>pkg_add</command></primary></indexterm>
      <screen>&prompt.root; <userinput>pkg_add -r <replaceable>lsof</replaceable></userinput></screen>

      <para>En el ejemplo anterior el package correspondiente se
        descargar&aacute; e instalar&aacute; sin intervenci&oacute;n
        del usuario.  Si desea utilizar una r&eacute;plica
	(&laquo;mirror&raquo;) de packages que no sea el sitio principal
        de &os; solo tiene configurar la variable de entorno
        <envar>PACKAGESITE</envar> correctamente para
        sobreescribir el sitio predefinido.  &man.pkg.add.1; utiliza
        &man.fetch.1; para descargar los ficheros, tomando como
        referencia varias variables de entorno, como
        <envar>FTP_PASSIVE_MODE</envar>, <envar>FTP_PROXY</envar> y
        <envar>FTP_PASSWORD</envar>.  Quiz&aacute;s deba modificar alguna de
        estas si se encuentra detr&aacute;s de un cortafuegos, o usa un
        proxy FTP/HTTP.  Consulte &man.fetch.3; si quiere ver una lista
        completa.  Observe tambi&eacute;n que en el ejemplo anterior
        usamos <literal>lsof</literal> en vez de
	<literal>lsof-4.56.4</literal>.  
        Cuando usamos la opci&oacute;n de descarga remota no es
        necesario especificar la versi&oacute;n del paquete.  
        &man.pkg.add.1; descargar&aacute; autom&aacute;ticamente la
        &uacute;ltima versi&oacute;n de la aplicaci&oacute;n.</para>

      <note>
	<para>&man.pkg.add.1; descargar&aacute; la &uacute;ltima
	  versi&oacute;n de su aplicaci&oacute;n si usa &os.current; o
	  &os.stable;, pero si usa una versi&oacute;n -RELEASE,
	  descargar&aacute; la versi&oacute;n del package que se
	  construy&oacute; con dicha versi&oacute;n.  Es posible configurar
	  esto sobreescribiendo la variable de entorno
	  <envar>PACKAGESITE</envar>.</para>
      </note>

      <para>Los packages se destribuyen en formatos
          <filename>.tgz</filename> y <filename>.tbz</filename>.  
          Puede encontrarlos en <ulink
          url="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/"></ulink>,
          o en la distribuci&oacute;n de &os; en CD-ROM.  Todos los
          CDs en el set de 4 CDs de &os; (y en el PowerPak, etc.)
          contienen packages en el directorio
          <filename>/packages</filename>.  La estructura de los
          packages es similar a la del arbol de
          <filename>/usr/ports</filename>.  Cada categor&iacute;a
          tiene su propio directorio, y todos los paquetes se pueden
          encontrar dentro del directorio <filename>All</filename>.
      </para>

      <para>La estructura del directorio de packageckages es id&eacute;ntica a la
        de los ports, y funcionan como un todo para conformar el sistema de
        paquetes/ports.
        </para>

    </sect2>

    <sect2>
      <title>Eliminar un package</title>
      <indexterm>
        <primary><command>pkg_delete</command></primary>
      </indexterm>
      <indexterm>
        <primary>packages</primary>
        <secondary>deleting</secondary>
      </indexterm>
      <para>Para eliminar un package instalado en el sistema utilice
	    &man.pkg.delete.1;.</para>

      <screen>&prompt.root; <userinput>pkg_delete <replaceable>xchat-1.7.1</replaceable></userinput></screen>
    </sect2>

    <sect2>
      <title>Miscel&aacute;nea</title>
      <para>Toda la informaci&oacute;n de los packages se guarda en
        <filename>/var/db/pkg</filename>.  Ah&iacute;l encontrar&aacute;
        la lista completa de paquetes instalados y las descripciones de
	los mismos.</para>
    </sect2>
  </sect1>
  
  <sect1 id="ports-using">
    <title>Uso de la colecci&oacute;n de ports</title>

    <para>La siguiente secci&oacute;n incluye las instrucciones
      b&aacute;sicas para instalar o eliminar programas mediante la
      Colecci&oacute;n de Ports de su sistema.</para>

    <sect2 id="ports-tree">
      <title>C&oacute;mo obtener la Colecci&oacute;n de Ports</title>

      <para>Para poder instalar ports primero debe hacerse, obviamente, con
        la Colecci&oacute;n de Ports&mdash;; en esencia est&aacute; compuesta
        por <filename>Makefiles</filename>, parches y ficheros con la
        descripci&oacute;n de los ports y est&aacute; en
        <filename>/usr/ports</filename>.</para>

      <para>Cuando instal&oacute; su sistema &os; el programa
	    <application>sysinstall</application> le pregunt&oacute; si
	    quer&iacute; instalar la Colecci&oacute;n de Ports.  
	    Si contest&oacute; que no siga estas instrucciones:</para>

      <procedure>
	<title>Mediante CVSup</title>

	<para>Este es un m&eacute;todo r&aacute;pido de conseguir y
	  mantener una copia de la Colecci&oacute;n de Ports al dia mediante
	  el protocolo <application>CVSup</application>.  Si quiere saber
	  m&aacute;s sobre <application>CVSup</application> consulte <link
	    linkend="cvsup">Uso de CVSup</link>.</para>

	<note>
	  <para>La implementaci&oacute;n del protocolo
	    <application>CVSup</application> que se incluye en &os; se llama
	    <application>csup</application>.  Apareci&oacute; en &os;&nbsp;6.2.  
	    Los usuarios de releases anteriores de &os; puden instalar <filename
	      role="package">net/csup</filename> como port o package.</para>
	</note>

	<para>Aseg&uacute;rese de que <filename class="directory">/usr/ports</filename>
	  est&aacute; vac&iacute;o antes de ejecutar <application>csup</application>
	  por primera vez.  Si ya tiene la Colecci&oacute;n de Ports porque la
	  ha instalado por otros medios  <application>csup</application>
	  no purgar&aacute; los parches de ports eliminados.</para>

	<step>
	  <para>Ejecute <command>csup</command>:</para>

	  <screen>&prompt.root; <userinput>csup -L 2 -h <replaceable>cvsup.FreeBSD.org</replaceable> /usr/share/examples/cvsup/ports-supfile</userinput></screen>

	  <para>Cambie
	    <replaceable>cvsup.FreeBSD.org</replaceable> por alg&uacute;n
	    otro servidor <application>CVSup</application> que tenga cerca.  
	    Consulte <link linkend="cvsup-mirrors">R&eacute;plicas CVSup</link> (<xref
	    linkend="cvsup-mirrors">), donde encontrar&aacute; una lista
	    completa de las r&eacute;plicas CVSup.</para>

	  <note>
	    <para>Puede usar una versi&oacute;n de
	      <filename>ports-supfile</filename> confeccionada a su gusto,
	      por ejemplo para evitar tener que indicarle el nombre del
	      servidor <application>CVSup</application> a mano.</para>

	    <procedure>
	      <step>
		<para>Haga lo siguiente: como <username>root</username> copie
		  <filename>/usr/share/examples/cvsup/ports-supfile</filename>
		  en otro sitio, por ejemplo
		  <filename>/root</filename> o su directorio /home.</para>
	      </step>

	      <step>
		<para>Edite <filename>ports-supfile</filename>.</para>
	      </step>

	      <step>
		<para>Reemplace
		  <replaceable>CHANGE_THIS.FreeBSD.org</replaceable>
		  por un servidor <application>CVSup</application> que
		  est&eacute; cerca de donde est&eacute; usted.  Consulte
		  <link linkend="cvsup-mirrors">R&eacute;plicas
		  CVSup</link> (<xref linkend="cvsup-mirrors">) si necesita
		  ver una lista completa de las mismas.</para>
	      </step>

	      <step>
		<para>Ejecute <command>csup</command>del siguiente
		  modo:</para>

		<screen>&prompt.root; <userinput>csup -L 2 <replaceable>/root/ports-supfile</replaceable></userinput></screen>
	      </step>
	    </procedure>
	  </note>
	</step>

	<step>
	  <para>Al ejecutar &man.csup.1; descargar&aacute; y
	    aplicar&aacute; todos los cambios recientes que haya sufrido
	    la Colecci&oacute;n de Ports, pero tenga en cuenta que no
	    actualizar&aacute; ninguno de los ports que ya tenga instalados
	    en su sistema.</para>
	</step>
      </procedure>

      <procedure>
	<title>Mediante portsnap</title>

	<para><application>Portsnap</application> es un m&eacute;todo
	   alternativo de distribuir la Colecci&oacute;n de Ports.  Se
	   incluy&oacute; por primera vez en &os;&nbsp;6.0.  Puede
	   instalar &man.portsnap.8; en versiones anteriores de &os;
	   como port (<filename
	    role="package">ports-mgmt/portsnap</filename>) o como
	    package:</para>

	<screen>&prompt.root; <userinput>pkg_add -r portsnap</userinput></screen>

	<para>En
	  <link linkend="updating-portsnap">uso de portsnap</link>
	  encontrar&aacute; detallado el funcionamiento de
	  <application>Portsnap</application>
	  features.</para>

	<step>
	  <para>Puede saltarse esta paso a partir de &os;&nbsp;6.1-RELEASE
	    y en versiones recientes de
	    <application>Portsnap</application> (port o package).  
	    <filename
	    class="directory">/usr/ports</filename> se crear&aacute;
	    autom&aacute;ticamente la primera vez que ejecute 
	    &man.portsnap.8;.  En versiones anteriores de
	    <application>portsnap</application> hab&iacute;a que crear
	    un <filename
	      class="directory">/usr/ports</filename> vac&iacute;o si
	    no exist&iacute;a previamente:</para>

	  <screen>&prompt.root; <userinput>mkdir /usr/ports</userinput></screen>
	</step>

	<step>
	  <para>Descargue una instant&aacute;nea comprimida de la
	    Colecci&oacute;n de Ports en
	    <filename class="directory">/var/db/portsnap</filename>.  Hecho esto
	    puede desconectar de Internet si quiere.</para>

	  <screen>&prompt.root; <userinput>portsnap fetch</userinput></screen>
	</step>

	<step>
	  <para>Si est&aacute; ejecutando <application>Portsnap</application> por
	    vez primera debe extraer la instant&aacute;nea en <filename
	    class="directory">/usr/ports</filename>:
	  </para>

	  <screen>&prompt.root; <userinput>portsnap extract</userinput></screen>

	  <para>Si ya tiene un <filename
	    class="directory">/usr/ports</filename> y solamente est&aacute;
	    actualizando su &aacute;rbol de ports ejecute lo siguiente:</para>

	  <screen>&prompt.root; <userinput>portsnap update</userinput></screen>
	</step>

      </procedure>



      <procedure>
	<title>Mediante Sysinstall</title>

	<para>Este m&eacute;todo implica el uso de
	  <application>sysinstall</application> para
	  instalar la Colecci&oacute;n de Ports.</para>

	<step>
	  <para>Como usuario <username>root</username> ejecute
	    <command>sysinstall</command>
	    (<command>/stand/sysinstall</command> en cualquier versi&oacute;n
	    previa a &os;&nbsp;5.2); del siguiente modo:</para>

	  <screen>&prompt.root; <userinput>sysinstall</userinput></screen>
	</step>

	<step>
	  <para>Posici&oacute;nese en la opci&oacute;n
	    <guimenuitem>Configure</guimenuitem>
	    y pulse <keycap>Intro</keycap>.</para>
	</step>

	<step>
	  <para>Seleccione la opci&oacute;n
	  <guimenuitem>Distributions</guimenuitem>
	  y pulse <keycap>Intro</keycap>.</para>
	</step>

	<step>
	  <para>Seleccione la opci&oacute;n <guimenuitem>ports</guimenuitem>
	    y pulse la <keycap>barra espaciadora</keycap>.</para>
	</step>

	<step>
	  <para>Seleccione el medio de instalaci&oacute;n deseado (CDROM,
	    FTP, etc.)</para>
	</step>

	<step>
	  <para>Dir&iacute;jase a la opci&oacute;n
	    <guimenuitem>Exit</guimenuitem> y
	    pulse <keycap>Intro</keycap>.</para>
	</step>

	<step>
	  <para>Pulse <keycap>X</keycap> para salir de
            <application>sysinstall</application>.</para>
	</step>
      </procedure>

    </sect2>

    <sect2 id="ports-skeleton">
      <title>Instalaci&oacute;n de ports</title>

      <indexterm>
        <primary>ports</primary>
        <secondary>installing</secondary>
      </indexterm>
      <para>Al hablar de la Colecci&oacute;n de Ports lo primero que
        hay que explicar es a qu&eacute; nos referimos cuando hablamos de
        un &laquo;esqueleto&raquo; (skeleton).  El esqueleto de un
	port es un conjunto m&iacute;nimo de ficheros que
	indican a &os; c&oacute;mo compilar e instalar un programa.  
        Cada esqueleto incluye:</para>

      <itemizedlist>
	<listitem>
	  <para>Un <filename>Makefile</filename>.  Este
	    <filename>Makefile</filename> contiene diversas sentencias
	    que le indican al sistema c&oacute;mo compilarlo y d&oacute;nde
	    instalarlo en su sistema.</para>
	</listitem>

	<listitem>
	  <para>Un fichero <filename>distinfo</filename>.  Este fichero
	    contiene informaci&oacute;n sobre los ficheros que se debe 
	    descargar para poder compilar el programa, as&iacute; como el
	    identificador &laquo;checksum&raquo;, que se usa para comprobar
	    mediante &man.md5.1; que la descarga ha sido correcta y que el
	    la integridad del fichero est&aacute; garantizada.</para>
	</listitem>
	
	<listitem>
	  <para>Un directorio <filename>files</filename>.  Este directorio
	    contiene  los parches necesarios para compilar e instalar
	    el programa en su sistema &os;.  B&aacute;sicamente los parches
	    son peque&ntilde;os ficheros que especifican cambios en ficheros
	    concretos.  Su formato es en texto plano y suelen decir cosas
	    como &laquo;borra la l&iacute;nea 10&raquo; o
	    &laquo;Cambia la l&iacute;nea 26 por esto&raquo;.  
	    Estos parches tambi&eacute;n se conocen como
	    &laquo;diffs&raquo; ya que se generan con
	    &man.diff.1;.</para>

	  <para>Es posible que este directorio tambi&eacute; contenga
	    alg&uacute;n otro fichero necesario para compilar e instalar
	    el port.</para>
	</listitem>

	<listitem>
	  <para>Un fichero <filename>pkg-descr</filename>.  Es una
	    descripci&oacute;n m&aacute;s detallada del programa.  
	    En algunas ocasiones ocupa varias l&iacute;neas.</para>
	</listitem>
	
	<listitem>
	  <para>Un fichero <filename>pkg-plist</filename>.  Es una lista de
	    todos los ficheros que instalar&aacute; el port.  
	    Tambi&eacute;n le indica al sistema de ports qu&eacute; ficheros
	    eliminar durante la desinstalaci&oacute;n del programa.</para>
	</listitem>
      </itemizedlist>

      <para>Algunos ports tienen otros ficheros, como
        <filename>pkg-message</filename>.  El sistema de ports los usa para
        gestionar situaciones especiales.  Si desea conocer los detalles,
        incluso sobre los ports en general, consulte el libro <ulink
	url="http://www.FreeBSD.org/doc/en_EN.ISO8859-1/books/porters-handbook/index.html">&os; Porter's Handbook</ulink>.</para>

      <para>El port incluye las instrucciones necesarias para obtener
        software a partir del c&oacute;digo fuente, pero no incluye el
        c&oacute;digo.  Puede obtener el c&oacute;digo desde un CDROM
        o desde Internet.  El c&oacute;digo se distribuye del modo
        que el autor estime oportuno.  Normalmente es un fichero tar
        comprimido con gzip, pero puede comprimirse con otra herramienta o
        incluso no estar comprimido.  El c&oacute;digo del programa,
        venga como venga, se llama &laquo;distfile&raquo;.  A
	continuaci&oacute;n veremos los dos m&eacute;todos de
	instalaci&oacute;n de un port.</para>

      <note>
        <para>Debe ser el usuario <username>root</username> para
          instalar ports.</para>
      </note>

      <warning>
	<para>Antes de instalar cualquier port aseg&uacute;rese de tener la
	  Colecci&oacute;n de Ports actualizada y de comprobar en <ulink
	  url="http://vuxml.freebsd.org/"></ulink> la existencia de posibles
	  problemas de seguridad que pudiera tener el port.</para>

	<para>Puede realizar la comprobaci&oacute;n de seguridad
	  con <application>portaudit</application> antes de instalar
	  cualquier  aplicaci&oacute;n.  Esta herramienta est&aacute;
	  la Colecci&oacute;n de Ports (<filename
	  role="package">security/portaudit</filename>).  Le rogamos
	  que al menos considere ejecutar
	  <command>portaudit -F</command> antes de instalar un port nuevo
	  para que descargue la nueva base de datos de vulnerabilidades.  
	  Durante la comprobaci&oacute;n diaria de seguridad
	  actualizar&aacute; la base de datos y har&aacute; una
	  auditor&iacute;a del sistema.  Para m&aacute;s informaci&oacute;n
	  lea las p&aacute;ginas de man&uacute;al de
	  &man.portaudit.1; y &man.periodic.8;.</para>
      </warning>


      <para>La Colecci&oacute;n de  Ports asume que tiene usted conexi&oacute;n
        con Internet.  Si no es as&iacute; tendr&aacute; que disponer de una
	copia del distfile en <filename>/usr/ports/distfiles</filename>.</para>

	<para>El primer paso es ubicarse en el directorio del port que desea
	  instalar:</para>

        <screen>&prompt.root; <userinput>cd /usr/ports/sysutils/lsof</userinput></screen>

        <para>Una vez en el directorio <filename>lsof</filename> puede
	  ver el esqueleto del port.  El siguiente paso es compilar el
	  port.  Solamente tiene que teclear
	  typing <command>make</command> en el prompt.  Una vez hecho
	  ver&aacute; algo como esto:</para>

        <screen>&prompt.root; <userinput>make</userinput>
&gt;&gt; lsof_4.57D.freebsd.tar.gz doesn't seem to exist in /usr/ports/distfiles/.
&gt;&gt; Attempting to fetch from ftp://lsof.itap.purdue.edu/pub/tools/unix/lsof/.
===&gt;  Extracting for lsof-4.57
...
[La salida de la descompresi&oacute;n se ha eliminado]
...
&gt;&gt; Checksum OK for lsof_4.57D.freebsd.tar.gz.
===&gt;  Patching for lsof-4.57
===&gt;  Applying FreeBSD patches for lsof-4.57
===&gt;  Configuring for lsof-4.57
...
[La salida de la configuraci&oacute;n se ha eliminado]
...
===&gt;  Building for lsof-4.57
...
[La salida de la compilaci&oacute;n se ha eliminado]
...
&prompt.root;</screen>

        <para>Una vez que acabe la compilaci&oacute;n
	  se le devolver&aacute; el control del prompt.  El siguiente
	  paso es instalar el port.  Para ello bastar&aacute; con que
	  a&ntilde;ada una palabra aa la orden
	  onto the <command>make</command>: esa palabra es
	  <maketarget>install</maketarget>:</para>


        <screen>&prompt.root; <userinput>make install</userinput>
===&gt;  Installing for lsof-4.57
...
[La salida de la instalaci&oacute;n se ha eliminado]
...
===&gt;   Generating temporary packing list
===&gt;   Compressing manual pages for lsof-4.57
===&gt;   Registering installation for lsof-4.57
===&gt;  SECURITY NOTE:
      This port has installed the following binaries which execute with
      increased privileges.
&prompt.root;</screen>

	<para>Una vez que vuelva usted al prompt podr&aacute; ejecutar la
	  aplicaci&oacute;n que acaba de instalar.  Dado que
	  <command>lsof</command> es un programa que se ejecuta con
	  privilegios altos se le ha mostrado una advertencia de
	  seguridad.  Durante la compilaci&oacute;n e instalaci&oacute;n
	  es posible que hayan aparecido otros.</para>

	<para>Le recomendamos que borre el directorio que contiene todos
	  los ficheros temporales necesarios durante la compilaci&oacute;n.  
	  No solo consume valioso espacio en disco sino que puede dar
	  problemas cuando vaya a actualizar el port a una versi&oacute;n
          m&aacute;s reciente.</para>

	<screen>&prompt.root; <userinput>make clean</userinput>
===&gt;  Cleaning for lsof-4.57
&prompt.root;</screen>

        <note>
          <para>Puede ahorrarse teclear dos pasos si para instalar un port
	    teclea <command>make
	    <maketarget>install clean</maketarget></command> en lugar de
	    <command>make</command>,
	    <command>make <maketarget>install</maketarget></command> y
	    <command>make <maketarget>clean</maketarget></command>
	    as three separate steps.</para>
	</note>

	<note>
	  <para>Algunas shells mantienen una cach&eacute; de
	    &oacute;rdenes disponibles en los directorios que aparecen
	    en la variable de entorno
	    <envar>PATH</envar> con el fin de acelerar las operaciones
	    de b&uacute;squeda de ejecutables de esas &oacute;rdenes.  
	    Si usa una de esas shells tendr&aacute; que utilizar la
	    orden <command>rehash</command> tras instalar un port o
	    no podr&aacute; ejecutar aplicaciones reci&eacute;n
	    instaladas.  Esta orden funciona en shells como
	    <command>tcsh</command>.  Utilice <command>hash -r</command>
	    en shells <command>sh</command>.  Para m&aacute;s
	    informaci&oacute;n consulte la documentaci&oacute;n de
	    su shell.</para>
	</note>

	<para>Algunos DVD-ROM de terceros, como el &os; Toolkit
	  de <ulink url="http://www.freebsdmall.com/">&os;
	  Mall</ulink> contienen distfiles. Puede usarlos con la Colecci&oacute;n
	  de Ports.  Monte el DVD-ROM en <filename>/cdrom</filename>.  Si
	  utiliza un punto de montaje diferente asigne a
	  <makevar>CD_MOUNTPTS</makevar> el valor adecuado.  Los
	  distfiles se ir&aacute;n copiando autom&aacute;ticamente
	  a medida que vayan siendo necesarios.</para>

	<note>
	  <para>Por favor, tenga en cuenta que la licencia de unos
	    cuantos ports muy concretos no permite su distribuci&oacute;n
	    en CD-ROM.  Puede deberse a que es necesario rellenar un
	    formulario de registro antes de descargarlo, porque la
	    redistribuci&oacute;n no est&eacute; permitida o por otra
	    raz&oacute;n.  Si quiere instalar un port que no est&aacute;
	    en el CD-ROM tendr&aacute; que tener salida a Internet.</para>
	</note>

	<para>El sistema de ports utiliza &man.fetch.1; para descargar
	  ficheros; en este proceso intervienen varias variables de
	  entorno, como <envar>FTP_PASSIVE_MODE</envar>, <envar>FTP_PROXY</envar>,
	  y <envar>FTP_PASSWORD</envar>.  Si est&aacute; detr&aacute;s de
	  un cortafuegos tendr&aacute; que asignar valores a una o
	  m&aacute;s de estas variables, as&iacute; como si necesita
	  utilizar un proxy FTP/HTTP.  Consulte &man.fetch.3;, donde
	  econtrar&aacute; una lista detallada.</para>

	<para>La opci&oacute;n <command>make
	  <maketarget>fetch</maketarget></command> se cre&oacute; para
	  los usuarios que no disponen de conexi&oacute;n cont&iacute;nua.  
	  Ejecute esta orden en el directorio ra&iacute;z
	  (<filename>/usr/ports</filename>) y se descargar&aacute;n todos
	  los ficheros necesarios.  Esta orden tambi&eacute;n funciona en
	  directorios situados m&aacute;s abajo, por ejemplo
	  <filename>/usr/ports/net</filename>.  Tenga en cuenta que si un
	  port depende de librer&iacute;as u otros ports &eacute;stos
	  distfiles <emphasis>no</emphasis> no se descargar&aacute;n, a
	  menos que reemplace <maketarget>fetch</maketarget> por
	  <maketarget>fetch-recursive</maketarget>, que se encargar&aacute;
	  de descargar todas las dependencias de cada port.</para>

	<note><para>Si quiere compilar todos los ports de una
	  categor&iacute;a y de una sola vez ejecutando la orden
	  <command>make</command> en el directorio ra&iacute;z, de muy
	  similar manera que lo que se acaba de ver con
	  <command>make<maketarget>fetch</maketarget></command>.  Tenga en
	  cuenta que esto es bastante peligroso porque algunos ports no
	  pueden coexistir.  Tambi&eacute;n se dan casos de ports que
	  instalan instalan dos ficheros diferentes con el mismo
	  nombre.</para></note>

	<para>En algunos casos (raros) el usuario tendr&aacute; que
	  descargar los tarball de un sitio que no es el que se guarda
	  en la variable de entorno <makevar>MASTER_SITES</makevar>
	  (el sitio desde el que se descargan todos los dem&aacute;s
	  normalmente).  Puede sobreescribir la opci&oacute;n
	  <makevar>MASTER_SITES</makevar> con la siguiente
	  orden:</para>

	<screen>&prompt.root; <userinput>cd /usr/ports/<replaceable>directory</replaceable></userinput>
&prompt.root; <userinput>make MASTER_SITE_OVERRIDE= \
ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen>

	<para>In this example we change the
	  <makevar>MASTER_SITES</makevar> option to <hostid
	  role="fqdn">ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/</hostid>.</para>

	<note><para>Algunos ports permiten (o incluso exigen) que se le
	  faciliten opciones de compilaci&oacute;n para activar o desactivar
	  partes de la aplicaci&oacute;n que no se necesiten, determinadas
	  opciones de seguridad, etc.  Casos t&iacute;picos de esto son 
	  <filename role="package">www/mozilla</filename>, <filename
	  role="package">security/gpgme</filename>, and <filename
	  role="package">mail/sylpheed-claws</filename>.  Cuando debe
	  usted tomar este tipo de decisiones se le muestra un mensaje
	  con las opciones disponibles.</para></note>

      
      <sect3>
        <title>Sobreescribir directorios por omisi&oacute;n de ports</title>

	<para>Algunas veces es &uacute;til (u obligatorio) utilizar un
	  directorio de trabajo o un &laquo;target&raquo; distinto al
	  que tenemos por omisi&oacute;n.  Las variables de entorno
	  <makevar>WRKDIRPREFIX</makevar> y <makevar>PREFIX</makevar>
	  pueden sobreescribirse seg&uacute;n nuestra conveniencia.  Veamos
	  un ejemplo:</para>

	<screen>&prompt.root; <userinput>make WRKDIRPREFIX=/usr/home/ejemplo/ports install</userinput></screen>

	<para>compilar&aacute; el port en 
	    <filename>/usr/home/ejemplo/ports</filename> y lo instalar&aacute;
	    en <filename>/usr/local</filename>.</para>

	<screen>&prompt.root; <userinput>make PREFIX=/usr/home/ejemplo/local install</userinput></screen>

	<para>lo compilar&aacute; en <filename>/usr/ports</filename> y lo
	  instalar&aacute; en
	  <filename>/usr/home/ejemplo/local</filename>.</para>

	<para>Y por supuesto,</para>

	<screen>&prompt.root; <userinput>make WRKDIRPREFIX=../ports PREFIX=../local install</userinput></screen>

	<para>combinar&aacute; ambas; (ocupa demasiado para mostrarlo en una
	  p&aacute;gina, pero la idea general queda clara).</para>

	<para>Puede asignar valores a estas variables del mismo modo
	  que a cualquier otra de su entorno.  Consulte la
	  documentaci&oacute;n de su shell para m&aacute;s
	  informaci&oacute;n.</para>
      </sect3>

      <sect3>
	<title>Uso de <command>imake</command></title>

	<para>Algunos ports que usan <command>imake</command>
	  (un componente del Sistema X Window) no funcionan correctamente
	  con <makevar>PREFIX</makevar> e  insistir&aacute;n en instalarse
	  en <filename>/usr/X11R6</filename>.  Del mismo modo
	  algunos ports de Perl ignoran <makevar>PREFIX</makevar> y se
	  instalan en el &aacute;rbol de Perl.  Hacer que estos ports
	  respeten <makevar>PREFIX</makevar> es dif&iacute;cil y a veces
	  imposible.</para>
      </sect3>

      <sect3>
	<title>Reconfigurar ports</title>

	<para>Al compilar ciertos ports se le presentar&aacute; un
	  men&uacute; basado en ncurses en el cual podr&aacute; elegir
	  entre m&aacute;s o menos opciones de compilaci&oacute;n.  No es
	  raro que los usuarios quieran volver a usar ese men&uacute; para
	  a&ntilde;adir, quitar o cambiar opciones una vez que el port ya
	  est&aacute; compilado.  Hay bastantes formas de hacerlo.  Una
	  manera es entrar al directorio que contiene el port y teclear
	  containing the port and type <command>make
	  <maketarget>config</maketarget></command>, que har&aacute; que se
	  le presente de nuevo el men&uacute; con las opciones que estuvieran
	  seleccionadas previamente.  Otra opci&oacute;n es usar la orden
	  <command>make <maketarget>showconfig</maketarget></command>, que
	  le mostrar&aacute; todas las opciones de configuraci&oacute;n del
	  port.  Hay otra opci&oacute;n m&aacute;s, <command>make
	  <maketarget>rmconfig</maketarget></command>, que borrar&aacute;
	  todas las opciones que estuvieran seleccionadas y le permitir&aacute;
	  por tanto empezar desde cero.  Todas estas opciones y muchas
	  m&aacute;s las encontrar&aacute; descritas con gran detalle en
	  &man.ports.7;.</para>
      </sect3>


    </sect2>

    <sect2 id="ports-removing">
      <title>C&oacute;mo desinstalar ports</title>

      <indexterm>
        <primary>ports</primary>
        <secondary>removing</secondary>
      </indexterm>
      <para>Ahora que sabe instalar ports probablemente quiera saber
        c&oacute;mo eliminarlos; puede que haya instalado alguno y
        posteriormente se haya dado cuenta de que ha instalado el port
	incorrecto.  Vamos a desinstalar el port del ejemplo anterior
        (que, para todos aquellos que no estaban atentos,  era
	<command>lsof</command>).  Igual que al instalar ports, lo primero
	que debemos hacer es ubicarnos en el directorio del port que
	deseamos eliminar del sistema, en nuestro caso
	<filename>/usr/ports/sysutils/lsof</filename>.   Los ports se
	desinstalan exactamente igual que los packages; esto se
	explica en la <link
	linkend="packages-using">secci&oacute;N de packages</link>) utilizando
	la orden &man.pkg.delete.1;:</para>

      <screen>&prompt.root; <userinput>pkg_delete lsof-4.57</userinput></screen>


    <sect2 id="ports-upgrading">
      <title>Actualizaci&oacute;n de ports</title>

      <indexterm>
	<primary>ports</primary>
	<secondary>upgrading</secondary>
      </indexterm>
      <para>Antes de nada necesita ver una lista de ports instalados de
        los cuales exista una nueva versi&oacute;n en la Colecci&oacute;n
	de Ports.  Utilice &man.pkg.version.1;:</para>

      <screen>&prompt.root; <userinput>pkg_version -v</userinput></screen>

      <sect3 id="ports-file-updating">
	<title><filename>/usr/ports/UPDATING</filename></title>

	<para>Una vez actualizada la Colecci&oacute;n de Ports (y
	  <emphasis>antes</emphasis> de intentar actualizar ning&uacute;n
	  port) debe consultar
	  <filename>/usr/ports/UPDATING</filename>.  Este fichero describe
	  todas las novedades, problemas que pueden encontrarse y pasos que
	  deben seguir los usuarios al actualizar un port; hay cambios de
	  formato, cambios de ubicaci&oacute;n de ficheros de
	  configuraci&oacute;n o incompatibilidades con versiones
	  anteriores.</para>

	<para>Si <filename>UPDATING</filename> se contradice de cualquier modo
	  con lo que lea aqu&iacute; tenga muy encuenta que lo que aparezca en
	  <filename>UPDATING</filename> tiene prioridad absoluta.</para>
      </sect3>

      <sect3 id="portupgrade">
	<title>Actualizaci&oacute;n de ports con portupgrade</title>

	<indexterm>
	  <primary>portupgrade</primary>
	</indexterm>

      <para>La aplicaci&oacute;n <application>portupgrade</application>
        se dise&ntilde;&oacute; para actualizar f&aacute;cilmente los ports
	instalados en un sistema.  Puede instalarla desde el port <filename
	role="package">ports-mgmt/portupgrade</filename>.  La
	instalaci&oacute;n es como al de cualquier otro port, use la orden
	<command>make <maketarget>install
	clean</maketarget></command> command:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/ports-mgmt/portupgrade</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>

      <para>Compruebe la lista de ports instalados con <command>pkgdb
	-F</command> y arregle todas las inconsistencias que aparezcan.  Le
	recomendamos que haga esta comprobaci&oacute;n de forma regular y
	siempre antes de una actualizaci&oacute;n.</para>

      <para>Si ejecuta <command>portupgrade -a</command>
	<application>portupgrade</application> intentar&aacute; actualizar
	todos y cada uno de los ports instalados en su sistema.  Utilice el
	par&aacute;metro <option>-i</option> si quiere que le pida
	confirmaci&oacute;n antes de actualizar cada uno de los ports.</para>

      <screen>&prompt.root; <userinput>portupgrade -ai</userinput></screen>

      <para>Si solamente quiere actualizar una sola aplicaci&oacute;n (y no
        absolutamente todos los ports) utilice la orden <<command>portupgrade
	<replaceable>nombre-de-aplicaci&oacute;n</replaceable></command>.  
	A&ntilde;ada el modificador <option>-R</option> si quiere que
	<application>portupgrade</application> actualice antes todos los
	ports de los que depende la aplicaci&oacute;n en cuesti&oacute;n.</para>

      <screen>&prompt.root; <userinput>portupgrade -R firefox</userinput></screen>

      <para>Si quiere usar packages en lugar de ports use el modificador
	<option>-P</option> flag.  Con esta opci&oacute;n
	<application>portupgrade</application> busca en los directorios
	locales que aparezcan en <envar>PKG_PATH</envar> o descarga los
	packages desde un sitio remoto si es que no los encuentra en
	local.  Si es imposible encontrar los packages ni en local ni en
	remoto<application>portupgrade</application> utilizar&aacute;
	ports.  Si no quiere usar ports pase lo que pase utilice el
	modificador <option>-PP</option>.</para>

      <screen>&prompt.root; <userinput>portupgrade -PP gnome2</userinput></screen>

      <para>Si quiere solamente descargar los distfiles (o los packages,
	usando <option>-P</option>) sin compilar ni instalar nada,
	use <option>-F</option>.  Para m&aacute;s informaci&oacute;n
	consulte &man.portupgrade.1;.</para>
      </sect3>

      <sect3 id="portmanager">
	<title>Actualizaci&oacute;n de ports con portmanager</title>

	<indexterm>
	  <primary>portmanager</primary>
	</indexterm>

	<para><application>Portmanager</application> es otra aplicaci&oacute;n
	  pensada para la actualizaci&oacute;n sencilla de ports instalados
	  en el sistema.  Puede encontrarla en
	  <filename role="package">ports-mgmt/portmanager</filename>:</para>

	<screen>&prompt.root; <userinput>cd <filename class="directory">/usr/ports/ports-mgmt/portmanager</filename></userinput>
&prompt.root; <userinput>make install clean</userinput></screen>

	<para>Puede actualizar todos los ports que tenga instalados con
	  una sola orden:</para>

	<screen>&prompt.root; <userinput>portmanager -u</userinput></screen>

	<para>Si usa el modificador <option>-ui</option> se le pedir&aacute;
	  confirmaci&oacute;n a cada paso que <application>Portmanager</application>
	  vaya a dar.  <application>Portmanager</application> tambi&eacute;n
	  puede usarse para instalar nuevos ports.  A diferencia del habitual
	  <command>make <maketarget>install clean</maketarget></command>
	  actualizar&aacute; todos los ports que dependan antes de compilar e 
	  instalar ese port que queramos instalar.</para>

	<screen>&prompt.root; <userinput>portmanager <replaceable>x11/gnome2</replaceable></userinput></screen>

	<para>Si aparecen problemas con las dependencias del port que quiere
	  instalar puede usar <application>Portmanager</application> para
	  recompilar todos ello en el orden correcto.  Una vez que acabe el
	  port que estaba dando problemas ser&aacute; tambi&eacute;n
	  recompilado.</para>

	<screen>&prompt.root; <userinput>portmanager <replaceable>graphics/gimp</replaceable> -f</userinput></screen>

	<para>Para m&aacute;s informaci&oacute;n consulte &man.portmanager.1;.</para>
      </sect3>

      <sect3 id="portmaster">
	<title>Actualizaci&oacute;n de ports con portmaster</title>

	<indexterm>
	  <primary>portmaster</primary>
	</indexterm>

	<para><application>Portmaster</application> es otra aplicaci&oacute;n
	  para actualizar ports.  <application>Portmaster</application> se
	  dise&ntilde;&oacute; para que utilizara las herramientas del sistema
	  &laquo;base&raquo; (es decir, no depende de otros ports) y utiliza
	  la informaci&oacute;n que se almacena en el directorio
	  <filename class="directory">/var/db/pkg/</filename> para determinar
	  qu&eacute; port es el que hay que actualizar.  Puede encontrarlo en
	  <filename role="package">ports-mgmt/portmaster</filename>:</para>

	<screen>&prompt.root; <userinput>cd <filename class="directory">/usr/ports/ports-mgmt/portmaster</filename></userinput>
&prompt.root; <userinput>make install clean</userinput></screen>

	<para><application>Portmaster</application> agrupa los ports en cuatro
	  categor&iacute;as:</para>

	<itemizedlist>
	  <listitem>
	    <para>&laquo;Root ports&raquo; (no tienen dependencias, ning&uacute;n port depende de ellos)</para>
	    </listitem>
	  <listitem>
	    <para>&laquo;Trunk ports&raquo; (no tienen dependencias, otros ports dependen de ellos)</para>
	    </listitem>
	  <listitem>
	    <para>&laquo;Branch ports&raquo; (tienen dependencias, otros ports dependen de ellos)</para>
	    </listitem>
	  <listitem>
	    <para>&laquo;Leaf ports&raquo; (tienen dependencias, ning&uacute;n port depende de ellos)</para>
	    </listitem>
	</itemizedlist>

	<para>Puede ver una lista de los ports instalados y
	  buscar actualizaciones para ellos usando el modificador
	  <option>-L</option> :</para>

<screen>&prompt.root; <userinput>portmaster -L</userinput>
===>>> Root ports (No dependencies, not depended on)
===>>> ispell-3.2.06_18
===>>> screen-4.0.3
        ===>>> New version available: screen-4.0.3_1
===>>> tcpflow-0.21_1
===>>> 7 root ports
...
===>>> Branch ports (Have dependencies, are depended on)
===>>> apache-2.2.3
        ===>>> New version available: apache-2.2.8
...
===>>> Leaf ports (Have dependencies, not depended on)
===>>> automake-1.9.6_2
===>>> bash-3.1.17
        ===>>> New version available: bash-3.2.33
...
===>>> 32 leaf ports

===>>> 137 total installed ports
        ===>>> 83 have new versions available
</screen>

	<para>Con la siguiente orden puede actualizar todos los ports
	  del sistema:</para>

	<screen>&prompt.root; <userinput>portmaster -a</userinput></screen>

	<note><para>Por omisi&oacute;n <application>Portmaster</application>
	  guardar&aacute; una copia de seguridad (un package) de cada port
	  antes de borrarlo.  Si la instalaci&oacute;N de la nueva versi&oacute;n
	  funciona <application>Portmaster</application> borrar&aacute; el package.  
	  Si utiliza <option>-b</option> le dir&aacute; a
	  <application>Portmaster</application> que no borre autom&aacute;ticamente
	  el package.  Si usa el modificador <option>-i</option> arrancar&aacute;
	  <application>Portmaster</application> en modo interactivo, lo que significa
	  que le pedir&aacute; confirmaci&oacute;n antes de actualizar cada
	  port.</para></note>

	<para>Si se encuentra con errores durante el proceso de
	  actualizaci&oacute;n puede utilizar el modificador
	  <option>-f</option> para actualizar o recompilar todos
	  los ports:</para>

	<screen>&prompt.root; <userinput>portmaster -af</userinput></screen>

	<para>Tambi&eacute;n puede usar <application>Portmaster</application>para
	  instalar nuevos ports en el sistema, actualizando todas sus dependencias
	  antes de compilar e instalar el nuevo port:</para>

	<screen>&prompt.root; <userinput>portmaster <replaceable>shells/bash</replaceable></userinput></screen>

	<para>Por favor, consulte &man.portmaster.8; para m&aacute;s
	  informaci&oacute;n.</para>
      </sect3>
    </sect2>

    <sect2 id="ports-disk-space">
      <title>Los ports y el espacio en disco</title>

      <indexterm>
        <primary>ports</primary>
        <secondary>disk-space</secondary>
      </indexterm>
      <para>Usar la Colecci&oacute;n de Ports consume mucho espacio de
        disco seg&uacute;n pasa el tiempo.  Por culpa de la tendencia del
        &aacute;rbol de ports a crecer sin parar le recomendamos
	que despu&eacute;s de compilar e instalar sofware desde los ports
        recuerde limpiar los directorios temporales <filename
        class="directory">work</filename> mediante la orden
        <command>make <makevar>clean</makevar></command>.  Puede
	limpiar de un plumazo los directorios temporales de toda la
	Colecci&oacute;n de Ports con la siguiente orden:</para>

	<screen>&prompt.root; <userinput>portsclean -C</userinput></screen>

      <para>R&aacute;pidamente acumular&aacute; gran cantidad de viejas
        distribuciones de c&oacute;digo en
	<filename class="directory">distfiles</filename>.  Puede borrarlos
	a mano, pero tambi&eacute;n puede usar la siguiente orden para
	borrar todos los distfiles que no tengan relaci&oacute;n con
	ning&uacute;n port:</para>

      <screen>&prompt.root; <userinput>portsclean -D</userinput></screen>

      <para>Tambi&eacute;n puede borrar todos los distfiles sin relaci&oacute;n
      con ning&uacute;n port instalado en el sistema:</para>

      <screen>&prompt.root; <userinput>portsclean -DD</userinput></screen>

      <note>
	<para><command>portsclean</command> forma parte de la
	  &laquo;suite&raquo; <application>portupgrade</application>.</para>
      </note>

      <para>No olvide borrar los ports instalados una vez que deja de
         necesitarlos.  Hay una herramienta muy &uacute;til para ayudar
	 a automatizar esta tarea:
	<filename role="package">ports-mgmt/pkg_cutleaves</filename>.</para>


    </sect2>

  </sect1>

  <sect1 id="ports-nextsteps">
    <title>Despu&eacute;s de instalar un port</title>

    <para>Una vez que ha instalado una nueva aplicaci&oacute;n normalmente
      deber&aacute;a leer toda la documentaci&oacute;n que incluya, editar los
      ficheros de configuraci&oacute;n necesarios, asegurarse de que la
      aplicaci&oacute;n se ejecute al arrancar el sistema (si es un
      d&aelig;mon)etc.</para>

    <para>Obviamente los pasos exactos para configurar cada aplicaci&oacute;n
      son distintos de una a otra.  De cualquier forma, si acaba de instalar
      aplicaci&oacute;n y se pregunta
      &laquo;&iquest;Y ahora qu&eacute;?&raquo; estos consejos puede que le
      ayuden:</para>

    <itemizedlist>
      <listitem>
	<para>Use &man.pkg.info.1; para ver qu&eacute; ficheros se instalaron
	  y d&oacute;nde.  Por ejemplo, si instal&oacute;n
	  el paquete Un-Package 1.0.0, lo siguiente:</para>

	<screen>&prompt.root; <userinput>pkg_info -L un-package-1.0.0 | less</userinput></screen>

	<para>mostrar&aacute; los ficheros instalados por el paquete.  Preste
	  especial atenci&oacute;n a los ficheros en el directorio
	  <filename>man/</filename>, que son las p&aacute;ginas de ayuda y los
	  del directorio <filename>etc/</filename>, que contiene los ficheros
	  de configuraci&oacute;n; bajo el directorio <filename>doc/</filename>
	  podr&aacute; encontrar informaci&oacute;n m&aacute;s
	  detallada.</para>

	<para>Si no est&aacute; seguro de qu&eacute; versi&oacute;n del
	  paquete ha instalado, tecl&eacute;e:</para>

	<screen>&prompt.root; <userinput>pkg_info | grep -i <replaceable>un-package</replaceable></userinput></screen>

	<para>y ver&aacute; todos los paquetes que se llaman
	  <replaceable>un-package</replaceable>.  Reemplace
	  <replaceable>un-package</replaceable> en la l&iacute;nea de
	  &oacute;rdenes que tenga que usar en su caso.</para>
      </listitem>

      <listitem>
	<para>Una vez que ha identificado las p&aacute;ginas de manual
	  de la aplicaci&oacute;n rev&iacute;selas mediante &man.man.1;.  
	  Revise tambi&eacute;n los ficheros de configuraci&oacute;n,
	  as&iacute; como cualquier otro tipo de documentaci&oacute;n
	  que venga con el software.</para>
      </listitem>

      <listitem>
	<para>Si la aplicaci&oacute;n tiene sitio web vis&iacute;telo.  
	  Es muy posible que encuentre m&aacute;s documentaci&oacute;n,
	  listas de preguntas frecuentes (FAQ), etc.  Si no sabe cu&aacute;l
	  puede ser la direcci&oacute;n del sitio web examine la 
	  salida de la orden</para>

	<screen>&prompt.root; <userinput>pkg_info <replaceable>un-package-1.0.0</replaceable></userinput></screen>
	
	<para>a veces incluye una l&iacute;nea <literal>WWW:</literal>, que
	  contiene la direcci&oacute;n del sitio web de la
	  aplicaci&oacute;n.</para>
      </listitem>
      <listitem>
	<para>Los ports que deben arrancar con el sistema (como los
	  servidores de Internet) normalmente instalaran un 
	  &laquo;script&raquo; de
	  ejemplo en <filename>/usr/local/etc/rc.d</filename>.  Debe
	  revisar este &laquo;script&raquo; para comprobar que todo sea
	  correcto, editarlo o renombrarlo si fuera necesario.  Consulte
	   <link
	   linkend="configtuning-starting-services">C&oacute;mo arrancar
	    servicios</link> para m&aacute;s informaci&oacute;n.</para>

      </listitem>

    </itemizedlist>
  </sect1>
  <sect1 id="ports-broken">
    <title>Ports que no funcionan</title>

      <para>Si encuentra un port que no funciona hay varias cosas
        que puede hacer:</para>

      <orderedlist>
	<listitem>
	  <para>Consulte en la
	    <ulink url="http://www.freebsd.org/support.html#gnats">Base
	    de datos de informes de error</ulink> si ya se ha publicado
	    un parche que lo solucione.  Si es el caso puede aplicar
	    aplicar el parche en su sistema.</para>
         </listitem>

	 <listitem>
	   <para>Pida ayuda al responsable del mantenimiento
	     (conocido como &laquo;mantainer&raquo;) del port.  
	     Tecl&eacute;e <command>make maintainer</command> o
	     consulte el
	     <filename>Makefile</filename> del port si no sabe cu&aacute;l
	     es la direcci&oacute;n de correo del &laquo;mantainer&raquo;.  
	     Recuerde que debe incluir el nombre y la versi&oacute;n del
	     port.   Env&iacute;e la l&iacute;nea que contiene
	     <literal>&dollar;&os;:</literal> al principio del
	     <filename>Makefile</filename> del port y salida
	     con el error que obtiene al intentar usar la
	     aplicaci&oacute;n.</para>

          <note>
	     <para>Algunos ports no son responsabilidad de un individuo
	       sino de <ulink
	       url="http://www.freebsd.org/doc/en_US.ISO-8859-1/articles/mailing-list-faq/article.html">una lista de correo.</ulink>
	       Muchas, aunque no todas, tienen un aspecto parecido a
	       <email 
	       role="nolink">freebsd-nombredelalista@FreeBSD.org</email>.  
	       Por favor, t&eacute;ngalo en cuenta cuando envie ese correo
	       sobre el port que no funciona.</para>

            <para>Hay un caso especial: Los ports que tienen como
	       &laquo;mantainer&raquo;
               <email role="nolink">freebsd-ports@FreeBSD.org</email> en
	       realidad no son responsabilidad de nadie.  Los parches
	       y el soporte, en caso de existir, vienen de la comunidad de
	       usuarios y desarrolladores que est&aacute;n suscritos
	       a la lista.  Por cierto, siempre hacen falta m&aacute;s
	       voluntarios.</para>
	  </note>

            <para>Si no recibe respuesta utilice &man.send-pr.1; para
	      enviar un informe de errores.  Consulte
	      <ulink
	      url="http://www.freebsd.org/doc/en_US.ISO8859-1/articles/problem-reports/article.html">C&oacute;mo escribir informes de error</ulink>)
	      <footnote><para>
	        Hay traducci&oacute;n al castellano de este art&iacute;culo.  
		Est&aacute; aqu&iacute;: <ulink
		 url="http://www.freebsd.org/doc/es_ES.ISO8859-1/articles/problem-reports/article"></ulink>
	      </para></footnote>
	      </para>
	 </listitem>



        <listitem>
	  <para><emphasis>Arreglarlo</emphasis>. El &laquo;Porter's
	    Handbook&raquo; incluye informaci&oacute;n detallada
	    sobre la infraestructura de los ports, as&iacute; que
	    puede arreglar un port roto o incluso enviar su propio
	    port.</para>
	</listitem>


	<listitem>
	  <para>Descargue el paquete de alg&uacute;n sitio FTP.  El
	    servidor &laquo;principal&raquo; de la colecci&oacute;n
	    de paquetes est&aacute; en el 
	    <ulink
	    url="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/">directorio
	    de paquetes</ulink> de
	    <hostid
	    role="fqdn">ftp.FreeBSD.org</hostid>
	    <emphasis>pero aseg&uacute;rese de mirar antes en la
	    r&eacute;plica m&aacute;s pr&oacute;xima</emphasis>.  
	    Esta es una forma de instalar aplicaciones m&aacute;s
	    f&aacute;cil y m&aacute;s r&aacute;pida.  
	    Instale el paquete mediante &man.pkg.add.1;.</para
	</listitem>
      </orderedlist>
  </sect1>

</chapter>

<!--
     Local Variables:
     mode: sgml
     sgml-declaration: "../chapter.decl"
     sgml-indent-data: t
     sgml-omittag: nil
     sgml-always-quote-attributes: t
     sgml-parent-document: ("../book.sgml" "part" "chapter")
     End:
-->