summaryrefslogtreecommitdiffstats
path: root/solaris-inst.texinfo
blob: 45b24a9b58a3beb506f16717f6fbae4c1e1b5a93 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
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
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
\input texinfo
@c
@c search for "UPDATE!" for items that will need examination on future
@c releases
@c
@c This file may require a nonstandard texinfo.tex to format; if you
@c need it, please contact Cygnus Support (email editor-in-chief@cygnus.com)
@setfilename README.info
@c
@c This file describes how to install a Cygnus Progressive Release.
@c
@c Copyright (C) 1991, 1992 Cygnus Support
@c This text may be freely distributed under the terms of the GNU
@c General Public License.
@c
@c $Id$
@set CDROMinst
@clear CUSTOMER
@clear FIXMES
@c
@iftex
@c The include file "texiplus.tex" is in the texinfo/cygnus dir, and
@c implements Cygnus modifications to the texinfo manual style.
@input texiplus
@c The include file "smpklug.texi" is a kluge to deal with local
@c document production issues at Cygnus; it's safe to comment out this
@c line if you don't have (or don't want) the file.
@input smpklug.texi
@smallbook
@cropmarks
@setchapternewpage on
@finalout
@end iftex
@settitle Solaris--||RELNO|| Installation
@tex
% override-override: the following \font lines are redundant if you're
% using an unmodified FSF texinfo.  
\globaldefs=1
\font\texttt=cmtt10 scaled \magstephalf\let\tentt=\texttt
\font\textsl=cmsl10 scaled \magstephalf\let\tensl=\textsl
\font\textsf=cmss10 scaled \magstephalf\let\tensf=\textsf
\globaldefs=0
%end override-override
% WARNING: NONSTANDARD USAGE we need \tensf for print, without
% upsetting info.  We weren't using @b in this note, so I redefine it:
%
\global\def\b#1{{\tensf #1}}
\global\parindent=0pt
@end tex
@titlepage
@title Installation Notes
@sp 3
@table @strong
@item Cygnus Support Developer's Kit
@item Progressive Release ||RELNO|| for Solaris
@item {}
@item Contents
@end table
@c TOGGLE XREF DISPLAY TO AVOID SQUARE BRACKETS OR QUOTES:
@c (Cygnus "texiplus.tex" hack.  If you want standard texinfo remove
@c or comment-out instances of @altref).
@altref
@format
@ref{Brief,,Installing in Brief}
@ref{Contents,,Release Contents}.
@ref{Platforms,,Supported Platforms}.

@ref{Installing,,Installing the Developer's Kit}.
@ref{local-install,,Installing with local ||MEDIUM|| drive}.
@ref{cross-install,,Installing with another machine's ||MEDIUM|| drive}.
@ref{Examples,,Installation Examples}.

@ref{Paths,,Changing the Paths}
@ref{Trouble,,Some Things that Might go Wrong}
@ref{Rebuilding,,Rebuilding From Source}.
@ref{Removing,,Removing the Developer's Kit}.

@ref{Cygnus-FSF,,Cygnus Progressive Releases and the FSF}.
@ref{Cygnus-Support,,About Cygnus Support}.
@end format
@c TOGGLE XREF DISPLAY BACK, TO RESTORE MARKERS AROUND SECNAMES:

@altref
@author Cygnus Support @hfill hotline: +1 415 322 7836
@page

@tex
\def\$#1${{#1}} % Kluge: collect RCS revision info without $...$
\xdef\Rmanvers{{\it Installation Notes (Solaris Developer's Kit)}, \$Revision$} % *NOT* for use in headers, footers
{\parskip=0pt \hfill Cygnus Support\par \hfill \Rmanvers\par \hfill
\TeX{}info \texinfoversion\par }
\global\def\manvers{Progressive ||RELNO|| for Solaris}
@end tex

@vskip 0pt plus 1filll
Copyright @copyright{} 1991, 1992 Cygnus Support

Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
are preserved on all copies.

Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided also that
the entire resulting derived work is distributed under the terms of a
permission notice identical to this one.

Permission is granted to copy and distribute translations of this manual
into another language, under the above conditions for modified versions.

@end titlepage

@ifinfo
@node Top, Brief, (dir), (dir)
@top Overview

This file is about the Cygnus Developer's Kit for Solaris: what's in it,
how to install it, and how to reconfigure it.

@menu
* Brief::                       Installing in Brief
* Contents::                    Release Contents
* Requirements::                System Requirements
* Installing::                  Installing the Developer's Kit
* Running::                     Running the Programs
* Paths::                       Changing the Paths
* Trouble::                     Some Things that Might go Wrong
* Rebuilding::                  Rebuilding From Source
* Removing::                    Removing Parts of the Developer's Kit
* Cygnus-FSF::                  Cygnus Releases and the FSF
* Cygnus-Support::              About Cygnus Support

@end menu

@end ifinfo

@node Brief, Contents, Top, Top
@unnumbered Installing in Brief
@strong{You can run the brief installation procedure if:}
@itemize @bullet
@item
Your Solaris computer has its own ||MEDIUM|| drive 
@item
You use the default installation directory @file{/opt/gnu}, and
@item
You have at least ||DF|| MB available in @code{/opt} (try @samp{df /opt})
@end itemize
Otherwise, see @ref{Installing,,Installing the Developer's Kit}.

@strong{Steps for Brief Install:}

The whole procedure takes between ?? minutes and ???.

@enumerate
@item 
Make sure you have root access to the computer.

@cartouche
@example
eg$ @b{su} @b{root}
password:                   @i{(enter root password)}
@end example
@end cartouche

@item
Load the Progressive--||RELNO|| ||MEDIUM|| into your ||MEDIUM|| drive.

@ifset CDROMinst
@item
Mount the @sc{cd-rom}:

@cartouche
@example
eg# @b{mkdir} @b{/cdrom}             @i{(ignore any errors)}
eg# @b{mount} @b{-F} @b{hsfs} @b{-o} @b{ro} @b{/dev/dsk/c0t6d0s0} @b{/cdrom}
@end example
@end cartouche
@end ifset

@item
Run the @code{pkgadd} command like this:

@cartouche
@example
eg# @b{/usr/sbin/pkgadd} @b{-n} @b{-d} @b{||MEDstr||} @b{GNUDEVTkit} @b{GNUDEVTsrc}
@end example
@end cartouche

You will see messages about installation activity, ending with

@cartouche
@example
Cygnus Support software distribution installed!
@end example
@end cartouche

@item
Build a symbolic link to make execution paths easy:

@cartouche
@example
eg# @b{cd} @b{/opt/gnu}
eg# @b{ln} @b{-s} @b{progressive-||RELNO||} @b{progressive}
@end example
@end cartouche

@ifset CUSTOMER
@item
Use your Cygnus customer-ID (see cover letter) to tag your copy of our
problem-report form:

@cartouche
@example
eg# @b{/opt/progressive/bin/install@t{_}cid} @var{customerID}
@end example
@end cartouche
@end ifset

@end enumerate

You're done!  Anyone who puts @samp{/opt/progressive/bin} in her or his
@code{PATH} can use the Developer's Kit.

@node Contents, Requirements, Brief, Top
@unnumbered Release Contents

This Developer's Kit is a Cygnus Support @dfn{Progressive Release}: the
programs in it are recent versions, which have been tested and certified
both individually and as a coordinated suite of tools.
The kit includes both source and binaries for:  

@c UPDATE! Anything new shoveled in?
@table @r
@item @sc{gcc}
C compiler

@item @sc{gdb}
debugger

@item @sc{make}
compilation control program

@item Documentation Tools
@code{info}, @code{makeinfo}

@item Support Utilities
@code{patch}, the source-code update utility; @sc{gnu} @code{diff}; and
@code{send_pr}, the Cygnus problem-reporting utility
@end table

@menu
* Platforms::                   Supported Platforms
@end menu

@node Platforms,  , Contents, Contents
@unnumberedsec Supported Platforms

@table @strong
@item ||HOST||s
All programs in your Developer's Kit are for ||HOST||s running
Solaris; we ship binaries (configured to install and run under
@file{/opt/gnu}) as well as all source code.

@item Other Platforms
For information on other platforms or other programs
that we may support, please contact Cygnus Support at:

@table @strong
@item voice
+1 415 322 3811
@item hotline
+1 415 322 7836
@item fax
+1 415 322 3270
@item email
@code{info@@cygnus.com}
@end table
@end table

@menu
* Requirements::                System Requirements
@end menu

@node Requirements, Installing, Contents, Top
@unnumbered System Requirements

@table @strong
@item OS Level
Progressive Release ||RELNO|| for ||HOST||s requires Solaris 2.0 or
later. 

@item A ||MEDIUM|| Drive
You need access to a ||MEDIUM|| drive.  The ||MEDIUM|| drive need not be
on the computer where you want to run the software; but it is best if
the machine with a ||MEDIUM|| drive and your computer can mount a common
file system.  At the very least, you need some sort of file transfer
capability between the machine with a ||MEDIUM|| drive and your
computer.

@item Disk Space
The total space required to extract and install
binaries and source for all programs is
||DF|| megabytes.

The software is configured to go into @file{/opt/gnu}.  If you have
space available, but not in the same file system as @file{/opt}, you can
use @samp{ln -s} to create @file{/opt/gnu} as a symbolic link to the
file system where you do have the space available.

If you don't have enough space, you may be able to install binaries only;
see @ref{Limited Space,,Not Enough Space}.  The space required for
installing the binaries is ||BD|| megabytes.

@item Root Access
The standard Solaris installation procedures for optional packages
require you to run the installation with root privileges.  We deplore
this requirement, but consider it valuable nevertheless to conform to
the standard Solaris installation procedure.
@end table

@node Installing, Running, Requirements, Top
@unnumbered Installing the Developer's Kit

@iftex
This note shows the different parts of examples like this:
@table @asis
@item Computer output is shown in @code{typewriter font.}
@item Your input is indicated by @b{a sans-serif font.}
@item Text to replace, rather than typing verbatim, is in @var{this font}.
@item Comments appear in @i{italic font}.
@end table
@end iftex
In examples, we show the system prompt as @samp{eg#}.

The Cygnus Progressive--||RELNO|| ||MEDIUM|| is designed to work with
the Solaris administration command @code{pkgadd}.  

Two checklists follow.  The first checklist shows what to do if you have
a ||MEDIUM|| drive on the computer where you want to install the
Developer's Kit; the second shows how to use another networked machine
to read the ||MEDIUM||, then finish the installation on your computer.

Both checklists suggest installing the Developer's Kit binaries under
@file{/opt/gnu} (which can be a symbolic link from somewhere else, if
you like).  We recommend you use this location for the software, because
the precompiled, ready-to-run versions of the tools are configured this
way.  If you want to install elsewhere, see @ref{Paths,,Changing
the Paths}.)

Both checklists are very similar to @ref{Brief,,Installing in Brief},
but provide more discussion of each step, and offer alternatives for
systems whose available disk space is not in @code{/opt} and for
installing only portions of the Developer's Kit.

@menu
* local-install::               Installing with a local ||MEDIUM|| drive
* cross-install::               Installing with another machine's ||MEDIUM|| drive
* Examples::                    Installation Examples
* Why-fixincludes::             Why Convert System Header Files?
* Link::                        Easy Access and Updating
@end menu

@node local-install, cross-install, Installing, Installing
@unnumberedsubsec Installing with a local ||MEDIUM|| drive

This procedure is for a ||HOST|| that has its own ||MEDIUM|| drive.  The
complete procedure takes at least ?? minutes on a fast, unloaded
machine; it may take up to ??? in other situations.

@enumerate
@item 
Make sure you have root access to the computer.  The standard Solaris
installation procedures for optional packages require @code{root} to run
the complete installation.

@cartouche
@example
eg$ @b{su root}
password:                   @i{Enter root password.}
@end example
@end cartouche

@item
Check that you have enough space available in @file{/opt}
(@pxref{Requirements,,System Requirements}).  You can use @samp{df /opt}
to check.
@ifset FIXMES
@quotation
@emph{FIXME!} Does @code{pkgadd} check for this and issue an error?  If
so, recast in those terms?
@end quotation
@end ifset

@ifset CDROMinst
@item
Load the Catalyst CDWARE disk into a disk caddy, and put the caddy in
your CD-ROM drive.

@item
Mount the @sc{cd-rom}.  This note assumes your mount point for a
@code{cd-rom} is a directory called @file{/cdrom}; substitute to match
your site's conventions if necessary.

@c makeinfo seems unable to cope with nested ifset's when outer is off,
@c inner  is on.
@c @ifset FIXMES
@quotation
@emph{FIXME!} @file{/dev/dsk/c0t6d0s0} for @sc{cd-rom} cribbed from
Sun's generic optional-package install notes.  Is it really this cut and
dried?  What about systems with more than one @sc{cd-rom} drive?
@end quotation
@c @end ifset

@cartouche
@example
eg# @b{mkdir} @b{/cdrom}             @i{(ignore any errors)}
eg# @b{mount} @b{-F} @b{hsfs} @b{-o} @b{ro} @b{/dev/dsk/c0t6d0s0} @b{/cdrom}
@end example
@end cartouche
@end ifset

@ifclear CDROMinst
@item
Load the Cygnus Support release tape (labelled
``Progressive--||RELNO||'') into your system's tape drive.

@item
find out the name of the tape device on your machine that can read the
release tape.  Cygnus release tapes are labelled to identify the kind of
tape used.  You should use one of the following devices:

@ifset FIXMES
@quotation
@emph{FIXME!}  Does SVr4 specify device names enough that we can be more
explicit here?
@end quotation

@quotation
@emph{FIXME!}  For our own @code{Install}, we asked for
@emph{non-rewinding} tape device.  @code{pkgadd} doesn't say what kind
of tape devices it wants.  Does it matter?
@end quotation
@end ifset

@table @emph
@item ||TAPdflt|| tape
Use @file{||DEVdflt||} where the examples show @code{||MEDstr||}.

@item Exabyte ||MEDIUM||
The device name depends on how your Exabyte tape drive was installed;
ask your system administrator.  You will probably use something like
@file{/dev/???/a0b1c2d3} where we show @code{||MEDstr||}.
@end table
@end ifclear

@item
Now you can install ready-to-run binaries; or source; or both.

@itemize @bullet
@item
Choose source or binaries by running @code{pkgadd} with either or
both of the arguments @samp{GNUDEVTkit} (to install binaries) or
@code{GNUDEVTsrc} (for the source).  

@item
Run @code{pkgadd} interactively (that is, @emph{without} the @w{@samp{-n}}
option) to choose the installation directory.

@item
Use the @w{@samp{-d}} option to identify your ||MEDIUM||.
@end itemize

For instance, typing this command line starts installation of both
the source package and the binary package:

@cartouche
@example
eg# @b{/usr/sbin/pkgadd} @b{-d} @b{||MEDstr||} @b{GNUDEVTkit} @b{GNUDEVTsrc}
@end example
@end cartouche

@item
For each of the packages, @code{pkgadd} will ask for confirmation of the
install directory @file{/opt/gnu}, or an alternative.  

For the source package @code{GNUDEVTsrc}, place the package wherever
it's convenient; the only advantage of using the default location
@file{/opt/gnu} is to keep the source near the binaries.

For the @code{GNUDEVTkit} binaries, we recommend using the default location
@file{/opt/gnu}, since this location is configured and compiled into all
the tools.  

@quotation
@emph{Warning!} If you choose an alternate location for
@code{GNUDEVTkit} binaries, you will need to override the compiled-in
paths to run the programs.  @xref{Paths,,Changing the Paths}.
@end quotation

This example shows the interaction to accept @file{/opt/gnu} for the
binaries:

@cartouche
@example
Extracting Solaris GNU Developer's Kit binaries.
 >>Installing in "/opt/gnu".  OK?  [y/n]> @b{y}
@end example
@end cartouche

This example shows the interaction to place the source in
@file{/usr/local/src} instead of the default location.  After you type
the location, the installation script asks you to confirm.  You can use
this opportunity to avoid typographical errors in the install directory
name.

@cartouche
@example
Extracting Solaris GNU Developer's Kit source.
 >>Installing in "/opt/gnu".  OK?  [y/n]> @b{n}
 >>Where do you want to install?  > @b{/usr/local/src}
 >>Installing in "/usr/local/src".  OK? [y/n]> @b{y}
@end example
@end cartouche

@item
Installing the Developer's Kit binaries is a time-consuming step
(between ?? minutes and ???, depending on the speed of your machine).
@code{pkgadd} will display informative messages about its progress.
After the initial extraction step, it prepares copies of your system
header files, converted to comply better with @sc{ansi} C
(@pxref{Why-fixincludes,,Why Convert System Header Files?}).  A log for
this step goes in @file{/opt/gnu/progressive-||RELNO||/fixincludes.log}.
@emph{Your system's original header files are not changed;}
@code{pkgadd} writes the converted copies in a separate,
@sc{gcc}-specific directory.

When installation is complete, @code{pkgadd} displays the message

@cartouche
@example
Cygnus Support software distribution installed!
@end example
@end cartouche

@item
Now that the software is on your system, you should arrange for users
to run it conveniently.  We recommend the following symbolic link; see
@ref{Link,,Easy Access and Updating}, for a discussion.

@cartouche
@example
eg# @b{cd} @b{/opt/gnu}
eg# @b{ln} @b{-s} @b{progressive-||RELNO||} @b{progressive}
@end example
@end cartouche

@ifset CUSTOMER
@item
Finally, in case you need to send problem reports to Cygnus, we've
included a script @code{send_pr} (and a supporting online template) to
structure and transmit your reports.  Please use the small utility
script @code{install_cid} to record your Cygnus customer ID in your copy
of the problem report form.  (You can find your customer ID in the cover
letter that came with this release; or call the Cygnus hotline, 
@w{+1 415 322 7836}.)  This will enable us to respond as quickly as
possible to any problem reports you send.

@cartouche
@example
eg# @b{/opt/progressive/bin/install@t{_}cid @var{customerID}}
install_cid: `@var{customerID}' is now the default customer ID
 for send_pr
@end example
@end cartouche
@end ifset

@end enumerate

You're done!  Anyone who puts @samp{/opt/progressive/bin} in her or his
@code{PATH} can use the Developer's Kit.

@node cross-install, Examples, local-install, Installing
@unnumberedsubsec Installing with another machine's ||MEDIUM|| drive 
This checklist is for a ||HOST|| that does not have its own ||MEDIUM|| drive,
but can share a file system with another machine that does have a ||MEDIUM||
drive.  The other machine need not be a ||HOST||, @emph{but it must be
running some version of UNIX System V release 4}.  The complete
procedure takes between ?? and ???, depending on the speed of
each machine.

We show the other computer's prompt as @samp{other#}, and your
computer's prompt as @samp{eg#}.

@ifset FIXMES
@quotation
@emph{FIXME!} SVr4 required simply for presence of @code{pkgadd}
command.  If we care enough to relax this, we simply need to provide an
alternative extraction command-line.  @code{dd}?  @code{tar}?
@end quotation
@end ifset

@enumerate
@item
find a machine with a suitable ||MEDIUM|| drive on the same network as your
||HOST||, and sign on to it.  If the only machine with a ||MEDIUM||
drive isn't on the network, @pxref{No Drive,,No Local ||MEDIUM|| Drive}.

@item 
Make sure you have root access to @emph{both} computers.  The standard
Solaris installation procedures for optional packages require
@code{root} to run all installation steps.

@cartouche
@example
other$ @b{su} @b{root}
password:                   @i{(enter root password)}
@end example
@end cartouche

@item
Choose a directory where you will extract the Developer's Kit.  The
directory must be accessible from both machines (the one with the
||MEDIUM|| drive, and the ||HOST|| where you want to use the software).
If possible, use @file{/var/spool/pkg}; this is the default package
spooling directory for Solaris (and System V release 4 in general).

@ifset FIXMES
@quotation
@emph{FIXME!} Do SVr4 systems expect to export things like
@file{/var/spool/pkg}, or is this a nonsensical suggestion for
cross-install?
@end quotation
@end ifset

Wherever this note uses @var{shr}, substitute the name of the
directory you chose.

@item
Check that you have enough space available (@pxref{Requirements,,System
Requirements}) in @var{shr}.  You can use @samp{df @var{shr}} to check.
@ifset FIXMES
@quotation
@emph{FIXME!} Does @code{pkgadd} check for this and issue an error?  If
so, recast in those terms?
@end quotation
@end ifset

@ifset CDROMinst
@item
Load the Catalyst CDWARE disk into a disk caddy, and put the caddy in
your CD-ROM drive.

@item
Mount the @sc{cd-rom}.  This note assumes your mount point for a
@code{cd-rom} is a directory called @file{/cdrom}; substitute to match
your site's conventions if necessary.

@c makeinfo seems unable to cope with nested ifsets when outer is off,
@c inner is on.
@c @ifset FIXMES
@quotation
@emph{FIXME!} @file{/dev/dsk/c0t6d0s0} for @sc{cd-rom} cribbed from
Sun's generic optional-package install notes.  Is it really this
definite on @emph{all} SVr4 systems?  What about systems with more than
one @sc{cd-rom} drive?
@end quotation
@c @end ifset

@cartouche
@example
other# @b{mkdir} @b{/cdrom}             @i{(ignore any errors)}
other# @b{mount} @b{-F} @b{hsfs} @b{-o} @b{ro} @b{/dev/dsk/c0t6d0s0} @b{/cdrom}
@end example
@end cartouche
@end ifset

@ifclear CDROMinst
@item
Load the Cygnus Support release ||MEDIUM|| (labelled
``Progressive--||RELNO||'') into the tape drive.  In these examples,
@var{||MEDstr||} stands for the device name for the appropriate
tape drive on your system.

@item
find out the name of the tape device on the machine
that can read the release tape.  Cygnus release tapes are labelled to
identify the kind of tape used.  You should use one of the following
devices:
@ifset FIXMES
@quotation
@emph{FIXME!}  Does SVr4 specify device names enough that we can be more
explicit here?
@end quotation

@quotation
@emph{FIXME!}  For our own @code{Install}, we asked for
@emph{non-rewinding} tape device.  @code{pkgadd} doesn't say what kind
of tape devices it wants.  Does it matter?
@end quotation
@end ifset

@table @emph
@item ||TAPdflt|| ||MEDIUM||
Use @file{||DEVdflt||} where the examples show @code{||MEDstr||}.

@item Exabyte ||MEDIUM||
The device name depends on how your Exabyte ||MEDIUM|| drive was installed;
check with your system administrator.  You will probably use something like
@file{/dev/???/a0b1c2d3} where the example shows @code{||MEDstr||}.
@end table
@end ifclear

@item
Now you can extract either the ready-to-run binary package, the source
package, or both.  

@itemize @bullet
@item
Choose source or binaries by running @code{pkgadd} with either or
both of the arguments @samp{GNUDEVTkit} (to install binaries) or
@code{GNUDEVTsrc} (for the source).  

@emph{Warning:} later, when installing on your ||HOST||, only the
packages you extract now will be available.  We recommend you extract
both packages at this point.

@item
Use @samp{-s @var{shr}} to copy the packages to @var{shr}, where you
will be able to install them from your ||HOST||.

@item
Use the @w{@samp{-d}} option to identify your ||MEDIUM||.
@end itemize

This is the command line to extract both packages into @var{shr}:

@cartouche
@example
other# @b{/usr/sbin/pkgadd} @b{-s} @var{shr} @b{-d} @b{||MEDstr||} \
  @b{GNUDEVTkit} @b{GNUDEVTsrc}
@end example
@end cartouche

@item
Log off the computer with the ||MEDIUM|| drive, and log on to the
||HOST|| where you want to use the software.

@item 
Make sure you have root access to this computer, too.  The standard
Solaris installation procedures for optional packages require
@code{root} to run the complete installation.

@cartouche
@example
eg$ @b{su root}
password:                   @i{(enter root password)}
@end example
@end cartouche

@item
Check that you have enough space available in @file{/opt}
(@pxref{Requirements,,System Requirements}).  You can use @samp{df /opt}
to check.
@ifset FIXMES
@quotation
@emph{FIXME!} Does @code{pkgadd} check for this and issue an error?  If
so, recast in those terms?
@end quotation
@end ifset

@item
Now you can install ready-to-run binaries; or source; or both.

@itemize @bullet
@item
Choose source or binaries by running @code{pkgadd} with either or
both of the arguments @samp{GNUDEVTkit} (to install binaries) or
@code{GNUDEVTsrc} (for the source).  

@emph{Warning:} if you extracted only one of these packages when reading
the ||MEDIUM|| from another machine, you no longer have a choice---you
can only specify that package name to complete the installation.

@item
Run @code{pkgadd} interactively (that is, @emph{without} the @w{@samp{-n}}
option) to choose the installation directory.

@item
Use the @w{@samp{-d} @var{shr}} option to identify the shared directory
where you extracted the packages earlier.  (If you used
@file{/var/spool/pkg} as @var{shr}, you can leave off this option;
@code{pkgadd} uses that directory as the default location for packages
to install.)
@end itemize

For instance, typing this command line starts installation of both
the source package and the binary package:

@cartouche
@example
eg# @b{/usr/sbin/pkgadd} @b{-d} @var{shr} @b{GNUDEVTkit} @b{GNUDEVTsrc}
@end example
@end cartouche

@item
For each of the packages, @code{pkgadd} will ask for confirmation of the
install directory @file{/opt/gnu}, or an alternative.  

For the source package @code{GNUDEVTsrc}, place the package wherever
it's convenient; the only advantage of using the default location
@file{/opt/gnu} is to keep the source near the binaries.

For the @code{GNUDEVTkit} binaries, we recommend using the default location
@file{/opt/gnu}, since this location is configured and compiled into all
the tools.  

@quotation
@emph{Warning!} If you choose an alternate location for
@code{GNUDEVTkit} binaries, you will need to override the compiled-in
paths to run the programs.  @xref{Paths,,Changing the Paths}.
@end quotation

This example shows the interaction to accept @file{/opt/gnu} for the
binaries:

@cartouche
@example
Extracting Solaris GNU Developer's Kit binaries.
 >>Installing in "/opt/gnu".  OK?  [y/n]> @b{y}
@end example
@end cartouche

This example shows the interaction to place the source in
@file{/usr/local/src} instead of the default location.  After you type
the location, the installation script asks you to confirm.  You can use
this opportunity to avoid typographical errors in the install directory
name.

@cartouche
@example
Extracting Solaris GNU Developer's Kit source.
 >>Installing in "/opt/gnu".  OK?  [y/n]> @b{n}
 >>Where do you want to install?  > @b{/usr/local/src}
 >>Installing in "/usr/local/src".  OK? [y/n]> @b{y}
@end example
@end cartouche

@item
Installing the Developer's Kit binaries is a time-consuming step (at
least ?? minutes on a fast, unloaded machine; it may take as much as ???
under other circumstances).  @code{pkgadd} will display informative
messages about its progress.  After copying the binaries into their
installed locations, @code{pkgadd} prepares copies of your system header
files, converted to comply better with @sc{ansi} C
(@pxref{Why-fixincludes,,Why Convert System Header Files?}).  A log for
this step goes in @file{/opt/gnu/progressive-||RELNO||/fixincludes.log}.
@emph{Your system's original header files are not changed;}
@code{Install} writes the converted copies in a separate,
@sc{gcc}-specific directory.

When installation is complete, @code{pkgadd} displays the message

@cartouche
@example
Cygnus Support software distribution installed!
@end example
@end cartouche

@item
Now that the software is on your system, you need to arrange for users
to run it conveniently.  We recommend the following link; see
@ref{Link,,Easy Access and Updating}, for a discussion.

@cartouche
@example
eg# @b{cd} @b{/opt/gnu}
eg# @b{ln} @b{-s} @b{progressive-||RELNO||} @b{progressive}
@end example
@end cartouche

@ifset CUSTOMER
@item
Finally, in case you need to send problem reports to Cygnus, we've
included a script @code{send_pr} (and a supporting online form) to
structure and transmit your reports.  Please use the small utility
script @code{install_cid} to record your Cygnus customer ID in your copy
of the problem report form.  (You can find your customer ID in the cover
letter that came with this release; or call the Cygnus hotline, 
@w{+1 415 322 7836}.)  This will enable us to respond as quickly as
possible to any problem reports you send.

@cartouche
@example
eg# @b{/opt/progressive/bin/install@t{_}cid @var{customerID}}
install_cid: `@var{customerID}' is now the default customer ID
 for send_pr
@end example
@end cartouche
@end ifset

@end enumerate

You're done!  Anyone who puts @samp{/opt/progressive/bin} in her or his
@code{PATH} can use the Developer's Kit.

@node Examples, Why-fixincludes, cross-install, Installing
@unnumbered Installation Examples

Here are some examples covering common situations.

@menu
* binaries::                    Installing binaries only
* ||HOSTstr||-remote::          Reading ||MEDIUM|| on any machine, finishing on ||HOST||
* source-remove::               Removing Source
@end menu

@node binaries, ||HOSTstr||-remote, Examples, Examples
@unnumberedsubsec Installing binaries only

@c FIXME for texinfo??  The "ifsets" were originally only around the
@c portions of this example that depend on cdrom, but texinfo kept
@c not-finding the end-ifsets.  Does ifset break inside example?
@ifset CDROMinst
@cartouche
@example
eg$ @b{su} @b{root}
password:

@i{Insert ||MEDIUM|| into drive.}

eg# @b{mkdir} @b{/cdrom}
eg# @b{mount} @b{-F} @b{hsfs} @b{-o} @b{ro} @b{/dev/dsk/c0t6d0s0} @b{/cdrom}
eg# @b{/usr/sbin/pkgadd} @b{-n} @b{-d} @b{||MEDstr||} @b{GNUDEVTkit}

Extracting Solaris GNU Developer's Kit binaries.
 >>Installing in "/opt/gnu".  OK?  [y/n]> @b{y}

@i{Installation progress messages, ending with:}

Cygnus Support software distribution installed!

eg# @b{cd} @b{/opt/gnu}
eg# @b{ln} @b{-s} @b{progressive-||RELNO||} @b{progressive}
@end example
@end cartouche
@end ifset

@ifclear CDROMINST
@cartouche
@example
eg$ @b{su} @b{root}
password:

@i{Insert ||MEDIUM|| into drive.}

eg# @b{/usr/sbin/pkgadd} @b{-n} @b{-d} @b{||MEDstr||} @b{GNUDEVTkit}

Extracting Solaris GNU Developer's Kit binaries.
 >>Installing in "/opt/gnu".  OK?  [y/n]> @b{y}

@i{Installation progress messages, ending with:}

Cygnus Support software distribution installed!

eg# @b{cd} @b{/opt/gnu}
eg# @b{ln} @b{-s} @b{progressive-||RELNO||} @b{progressive}
@end example
@end cartouche
@end ifclear

If you don't want the source---for instance, to save space---you can use
the argument @samp{GNUDEVTbin} and omit @samp{GNUDEVTsrc}.

@node ||HOSTstr||-remote, source-remove, binaries, Examples
@unnumberedsubsec Reading ||MEDIUM|| on other machine, finishing on ||HOST||

@ifset CDROMinst
@cartouche
@example
@emph{On another SVr4 machine on your network with a ||MEDIUM|| drive:}
other$ @b{su} @b{root}
password:

@i{Insert ||MEDIUM|| into drive.}

other# @b{mkdir} @b{/cdrom}             @i{(ignore any errors)}
other# @b{mount} @b{-F} @b{hsfs} @b{-o} @b{ro} @b{/dev/dsk/c0t6d0s0} @b{/cdrom}
other# @b{/usr/sbin/pkgadd} @b{-s} @var{/var/spool/pkg} @b{-d} @b{||MEDstr||} \
  @b{GNUDEVTkit} @b{GNUDEVTsrc}
other# exit

@emph{On your ||HOST||}
eg$ @b{su} @b{root}
password:
eg# @b{/usr/sbin/pkgadd} @b{GNUDEVTkit} @b{GNUDEVTsrc}

Extracting Solaris GNU Developer's Kit binaries.
 >>Installing in "/opt/gnu".  OK?  [y/n]> @b{y}

Extracting Solaris GNU Developer's Kit source.
 >>Installing in "/opt/gnu".  OK?  [y/n]> @b{y}

@i{Installation progress messages, ending with:}

Cygnus Support software distribution installed!

eg# @b{cd} @b{/opt/gnu}
eg# @b{ln} @b{-s} @b{progressive-||RELNO||} @b{progressive}
@end example
@end cartouche
@end ifset

@ifclear CDROMinst
@cartouche
@example
@emph{On another SVr4 machine on your network with a ||MEDIUM|| drive:}
other$ @b{su} @b{root}
password:

@i{Insert ||MEDIUM|| into drive.}

other# @b{/usr/sbin/pkgadd} @b{-s} @var{/var/spool/pkg} @b{-d} @b{||MEDstr||} \
  @b{GNUDEVTkit} @b{GNUDEVTsrc}
other# exit

@emph{On your ||HOST||}
eg$ @b{su} @b{root}
password:
eg# @b{/usr/sbin/pkgadd} @b{GNUDEVTkit} @b{GNUDEVTsrc}

Extracting Solaris GNU Developer's Kit binaries.
 >>Installing in "/opt/gnu".  OK?  [y/n]> @b{y}

Extracting Solaris GNU Developer's Kit source.
 >>Installing in "/opt/gnu".  OK?  [y/n]> @b{y}

@i{Installation progress messages, ending with:}

Cygnus Support software distribution installed!

eg# @b{cd} @b{/opt/gnu}
eg# @b{ln} @b{-s} @b{progressive-||RELNO||} @b{progressive}
@end example
@end cartouche
@end ifclear

@noindent
If your ||HOST|| doesn't have a ||MEDIUM|| drive, but another SVr4
machine that can mount a shared directory (here the default
package-spooling directory, @samp{/var/spool/pkg}) does have one, you
can carry out the first step of the installation from the machine with a
||MEDIUM|| drive, as shown.  Note that you have to use @samp{-s} on
the @code{pkgadd} command line.  This alerts @code{pkgadd} to stop the
install procedure after it reads the ||MEDIUM||.  You still have to
finish the installation, but the last two steps have to run on your
||HOST||.  

@node source-remove,  , ||HOSTstr||-remote, Examples
@unnumberedsubsec Removing Source
The @code{pkgrm} command can remove any package installed by
@code{pkgadd}.  For example, if after installing the complete
Developer's Kit on your machine you decide to remove the source files:

@cartouche
@example
eg$ @b{su} @b{root}
password:
eg# @b{/usr/sbin/pkgrm GNUDEVTsrc}
@end example
@end cartouche

@node Why-fixincludes, Link, Examples, Installing
@unnumberedsec Why Convert System Header Files?

@ifset FIXMES
@quotation
@emph{FIXME!} This is pretty much the standard progressive blurb about
fixincludes.  Surely it's bogus here, since Solaris is a nice modern
system?  Doesn't it have ANSI header files?

Someone, please confirm or deny!  I seem to recall there's at least some
bullshit about how @code{__ANSIC__} or some such thing is defined.
Specifics, anyone?
@end quotation
@end ifset

You may notice messages about running @samp{fixincludes} during your
Developer's Kit installation.  When the @sc{ansi x3j11} committee
finished developing a standard for the C language, a few things that had
worked one way in many traditional C compilers ended up working
differently in @sc{ansi} C.  Most of these changes are improvements.
But some Unix header files still rely on the old C meanings, in cases
where the Unix vendor has not yet converted to using an @sc{ansi} C
compiler for the operating system itself.  The @samp{fixincludes}
portion of installation is a mechanical translation that writes
@sc{ansi} C versions of some system header files into a new,
@sc{gcc}-specific include directory---@emph{your system's original
header files are not affected.}

The particular problems fixed include:
@itemize @bullet
@item
@code{_IOR}, @code{_IOW}, and @code{_IORW} macros use obsolete
preprocessor facilities
@item
@code{#endif} no longer ignores its argument
@end itemize

If you don't run @code{fixincludes}, the GNU C compiler can only use the
original system header files when you compile new C programs.  @emph{In
some cases, the resulting programs will fail at run-time}.

@node Link, , Why-fixincludes, Installing
@unnumbered Easy Access and Updating
Once you've extracted them from the ||MEDIUM||, the Developer's Kit
tools are installed under a directory named
@file{progressive-||RELNO||}.  We put the release number in the
directory name so that you can keep several releases installed at the
same time, if you wish.  In order to simplify administrative procedures
(such as upgrades to future Cygnus Progressive releases), we recommend
that you establish a symbolic link @file{/opt/gnu/progressive} to this
directory.  For example, assuming you've used the default installation
path:

@cartouche
@example
eg# @b{cd /opt/gnu}
eg# @b{ln -s progressive-||RELNO|| progressive}
@end example
@end cartouche

We recommend building this link as the very last step in the
installation process.  That way, users at your site will only see
software in @file{/opt/gnu/progressive} when you're satisfied that the
installation is complete and successful.

@node Running, Paths, Installing, Top
@unnumbered Running the Programs
Any users who wish to run the Cygnus development tools will need to make
sure the @code{PATH} environment variable will find them.  If you create
the symbolic link we recommend above, users who want to run the
Developer's Kit---regardless of whether they need binaries for a ||HOST||,
or for some other platform---can use settings like one of the following
in their initialization files.

@example
@exdent For shells compatible with Bourne shell (e.g. @code{/bin/sh}, @code{bash}, or Korn shell):
@cartouche
@b{PATH=/opt/gnu/progressive/bin:$PATH}
@b{export PATH}
@end cartouche
@end example

@example
@exdent For C shell:
@cartouche
@b{set path=(/opt/gnu/progressive/bin $path)}
@end cartouche
@end example

@noindent
You should also ensure that your @code{man} command can pick up the
manual pages for these tools.  Some @code{man} programs recognize a
@code{MANPATH} environment variable.  If your @code{man} program is one
of these, users at your site can also include in their initialization
file lines like 

@example
@exdent For Bourne-compatible shells:
@cartouche
@b{MANPATH=/opt/gnu/progressive/man:$MANPATH:/opt/man}
@b{export MANPATH}
@end cartouche
@end example

@example
@exdent For C shell:
@cartouche
@b{setenv MANPATH /opt/gnu/progressive/man:$MANPATH:/opt/man}
@end cartouche
@end example

If your @code{man} program doesn't recognize @samp{MANPATH}, you may
want to copy or link the files from
@file{progressive/man/man1} into your system's
@file{man/man1}. @refill

@node Paths, Trouble, Running, Top
@unnumbered Changing the Paths
The binaries shipped by Cygnus are configured for installation under the
directory @file{/opt/gnu}.  If you wish to run the tools in another
location, the best solution---and, to date, the only complete one---is
to rebuild them from source.  @xref{Rebuilding,,Rebuilding from Source}.

In particular, @code{gcc} and the documentation browser @code{info} need
to know the location of the distribution.

@subheading GCC Paths
@ifset FIXMES
@quotation
@emph{FIXME!} Add something about specs file?
@end quotation
@end ifset
You can run the compiler @sc{gcc} without recompiling, even if you
install the distribution in an alternate location, by first setting the
environment variable @samp{GCC_EXEC_PREFIX}.  This variable specifies
where to find the executables, libraries, and data files used by the
compiler.  Its value will be different depending on which set of
binaries you need to run.  For example, if you install the Developer's Kit
binaries under @file{/local} (instead of the default
@file{/opt/gnu}), and you wish to run @sc{gcc} from there, 
you could set @samp{GCC_EXEC_PREFIX} as follows.  (You can
type the first two lines as a single line, if you like; the example
is split using the line continuation character @samp{\} only
to make it fit on the printed page.)

@cartouche
@example
@b{GCC@t{_}EXEC@t{_}PREFIX=/local/progressive-||RELNO||/@t{\}
lib/gcc/||TARGET||/||GCCvn||/}
@b{export GCC@t{_}EXEC@t{_}PREFIX}
@end example
@end cartouche

@noindent
The example assumes you use a shell compatible with the Bourne shell; if
you run the C shell, use the following instead.  (Again, the line
continuation character @samp{\} is only used for convenience in the
example; feel free to use a single line.)

@cartouche
@example
@b{setenv GCC@t{_}EXEC@t{_}PREFIX /local/progressive-||RELNO||/@t{\}
lib/gcc/||TARGET||/||GCCvn||/}
@end example
@end cartouche

@quotation
@emph{Warning: The trailing slash @samp{/} is important}.  The @code{gcc}
program uses @samp{GCC_EXEC_PREFIX} simply as a prefix.  If you omit the
slash (or make any other mistakes in specifying the prefix), @code{gcc}
will fail with a message beginning @samp{installation problem, cannot
exec@dots{}}.
@end quotation

@subheading @code{info} Paths
You can use the @w{@samp{--directory}} option, each time you run @code{info},
to specify a non-default location for the documentation files.  For
example, if you read the distribution ||MEDIUM||s into @file{/local},
you could run @code{info} as follows:

@cartouche
@example
@b{info --directory /local/progressive-||RELNO||/info}
@end example
@end cartouche

@quotation
@emph{Warning:} the directory you specify with @code{--directory}
@emph{must} contain at least the structured file called @code{dir},
which specifies the menu structure that leads to the other documentation
files.
@end quotation

You can also run @code{info} on a specific documentation file,
regardless of its location, by giving the option @code{-file} followed
by a pathname to the desired file; or you can use the command
@code{g(@var{filename})} to the same effect, after entering the
@code{info} program.

@node Trouble, Rebuilding, Paths, Top
@unnumbered Some Things that Might go Wrong

We've tried to make the installation of your Developer's Kit as painless
as possible.  Still, some complications may arise.  Here are suggestions
for dealing with some of them.

@menu
* No Drive::                    No Local ||MEDIUM|| Drive
* Limited Space::               Not Enough Space
* Install errors::              Error Messages from @code{Install}
@end menu

@node No Drive, Limited Space, Trouble, Trouble
@unnumberedsec No Local ||MEDIUM|| Drive
If your ||HOST|| doesn't have an appropriate ||MEDIUM|| drive, you may
still be able to install your software.  Check with your system
administrator to see if another machine that runs Unix SVr4 at your site
has a ||MEDIUM|| drive you can use.  If so:

@emph{If a shared filesystem is available} between the two machines, and
it has enough space, see @ref{cross-install,,Installing with another
machine's ||MEDIUM|| drive}.

@node Limited Space, Install errors, No Drive, Trouble
@unnumberedsec Not Enough Space
If you don't have enough space to install all of the ||MEDIUM||
distribution, you can instead extract only the compiled code, or only
the source.

The following table summarizes the approximate space (rounded up to the
next megabyte) needed for source and binaries.
There is a little overlap between the partial installations: the
documentation, and documentation tools, are always installed.

@table @r
@item ||BD|| MB
||HOST|| binaries

@item ||SD|| MB
source code for all programs

@item ||DF|| MB
total
@end table

You can easily extract these components independently of one another, by
using the @samp{GNUDEVTsrc} or @samp{GNUDEVTbin} arguments to @code{pkgadd}.

@node Install errors,  , Limited Space, Trouble
@unnumberedsec Error Messages from @code{Install}
The @code{Install} script checks for many errors and inconsistencies in
the way its arguments are used.  The messages are meant to be
self-explanatory.  Here is a list of a few messages where further
information might be useful:

@ifset FIXMES
@quotation
@emph{FIXME!} These are probably bogus, they're basically from Cygnus
@code{Install}.
@end quotation
@end ifset
@table @code
@item Cannot read from device @var{||MEDstr||}
The error message ends with the ||MEDIUM|| device or directory that
@code{pkgadd} was trying to use.  Please check that it is the device you
intended; possible causes of trouble might include leaving off the
@samp{/dev/} prefix at the front of a device name.  A typo in the
device name might also cause this problem.

If the problem is neither of these things, perhaps your ||MEDIUM||
device can't read our ||MEDIUM||; @pxref{No Drive,,No Local ||MEDIUM||
Drive}, for a discussion of how to use another machine's ||MEDIUM||
drive.

@item @dots{} This is a problem.
@itemx Cannot cd to @var{installdir}
@itemx I do not know why I cannot create @var{installdir}
@itemx hello.c fails to run
@itemx test-ioctl.c fails to run
@itemx I do not know how to remove an arch called @dots{}
These errors (the first covers anything that ends in @samp{This is a
problem}) are from paranoia checks; they are issued for situations that
other checks should have covered, or for unlikely situations that
require further diagnosis.  

If you get one of these messages, please 
@itemize @bullet
@item
@strong{call the Cygnus hotline, +1 415 322 7836}, or 
@item
send electronic mail to @samp{help@@cygnus.com}. 
@end itemize
@end table

@node Rebuilding, Removing, Trouble, Top
@unnumbered Rebuilding From Source

All Cygnus products are free software; your Developer's Kit includes
complete source code for all programs.

Cygnus Support has implemented an automatic configuration scheme to
adapt the programs to different environments.

Rebuilding the programs from source requires these steps:
@enumerate
@item
configuration
@item
compilation
@item
installation
@end enumerate

For example, executing the following commands in sequence will rebuild
and install a native version of all the tools in a nonstandard
directory:

@cartouche
@example
@b{cd progressive/src}
@b{./configure ||HOSTstr|| -prefix=/local/gnu}
@b{make clean all install}
@end example
@end cartouche

@noindent
We discuss each step in detail in the following sections.

@menu
* Configuration::               Configuration
* Config Names::                Specifying Names for Hosts and Targets
* configure Options::           @code{configure} Options
* Compilation::                 Compilation
* Installation::                Installation
@end menu

@node Configuration, Config Names, Rebuilding, Rebuilding
@unnumberedsec Configuration

You can configure the software in this release by using the shell
script called @code{configure}.  The shell script requires one argument:
the host type.  There are also several possible options, including a
@w{@samp{-target=}} option to configure for cross-system development.

@node Config Names, configure Options, Configuration, Rebuilding
@section Specifying Names for Hosts and Targets

The specifications used for hosts and targets in the @code{configure}
script are based on a three-part naming scheme, but some short predefined
aliases are also supported.  The full naming scheme encodes three pieces
of information in the following pattern:

@example
@var{architecture}-@var{vendor}-@var{os}
@end example

@ifset FIXMES
@quotation
@emph{FIXME!} What is real alias for Solaris/SPARC?
@end quotation
@end ifset
For example, you can use the alias @code{solar} as a @var{host} argument
or in a @w{@samp{-target=@var{target}}} option, but the equivalent full name
is @samp{sparc-sun-solaris2}.

@quotation
@emph{Warning:} @code{configure} can represent a very large number of
combinations of architecture, vendor, and OS.  There is by no means
support for all possible combinations!
@end quotation

@node configure Options, Compilation, Config Names, Rebuilding
@section @code{configure} Options

This section summarizes the @code{configure} options and arguments.
Your Developer's Kit contains full online documentation for the Cygnus
configure system.  @inforef{Using Configure,,configure.info}, to read
about @code{configure} in more detail, including information on how the
@code{configure} options relate to @file{Makefile} variables.

@example
configure @r{[}-prefix=@var{dest}@r{]} 
          @r{[}-exec-prefix=@var{bindest}@r{]} 
          @r{[}-srcdir=@var{path}@r{]}
          @r{[}-norecursion@r{]} 
          @r{[}-target=@var{target}@r{]}
          @var{host}
@end example

@ifset FIXMES
@quotation
@emph{FIXME!} Show complete configure option list used for release?
@end quotation
@end ifset
@table @code
@item -prefix=@var{dest}
@var{dest} is an installation directory @emph{path prefix},
the root for the directories where @code{make install} will
place things.  After you configure with this option, @code{make install}
will install info files in @file{@var{dest}/info}, man pages in
@file{@var{dest}/man}, and---unless you also use
@w{@samp{-exec-prefix}}---compiled programs in @file{@var{dest}/bin},
and libraries in @file{@var{dest}/lib}. 
If you specify @w{@samp{-prefix=/local}}, for example, @code{make
install} puts the development tools in @file{/local/bin}.

@emph{WARNING:} the default @var{dest} path prefix in the source is not
the same as the prefix for the preconfigured binaries distributed by Cygnus.

@w{@samp{-prefix=/opt/gnu/progressive-||RELNO||}} was used to build this
Cygnus Progressive Release.  If you do not use @w{@samp{-prefix}}, the
installation directory is @file{/usr/local}.

@item -exec-prefix=@var{bindest}
@w{@samp{-exec-prefix}} serves the same purpose as @w{@samp{-prefix}}, but
affects only machine-dependent targets (compiled programs and
libraries).  Specifying both @w{@samp{-prefix}} and @w{@samp{-exec-prefix}}
allows you to segregate machine-dependent files, so that
machine-independent files can be shared.  

@emph{WARNING:} the default @var{bindest} path prefix in the source is not
the same as the prefix for the preconfigured binaries distributed by Cygnus.

@w{@samp{-exec-prefix=/opt/gnu/progressive-||RELNO||}} was
used to build this Cygnus Progressive Release.
If you do not use @w{@samp{-exec-prefix}}, the default directory for
machine-dependent targets is whatever was specified with @file{-prefix}
(by default, @file{/usr/local}).

@item -srcdir=@var{path}
@emph{Warning: This option is only supported if you use @sc{gnu}
@code{make}} (which is included in this Cygnus Progressive--||RELNO|| release).
Use this option to make configurations in directories separate from the
source directories. @code{configure} writes configuration specific files
in the current directory, but arranges for them to use the source in the
directory @var{path}.  @code{configure} will create directories under
the working directory in parallel to the source directories below
@var{path}.  Among other things, you can use this to build (or maintain)
several configurations simultaneously, in separate directories.

@item -norecursion
Configure only the directory level where @code{configure} is executed; do not
propagate configuration to subdirectories.

@item -target=@var{target}
Configure the development tools for cross-development (compiling,
debugging, or other processing) of programs running on the specified
@var{target}.  Without this option, programs are configured ``native'',
that is, for managing programs that run on the same machine (@var{host})
as the development tools themselves.

There is no convenient way to generate a list of all available targets.

@item @var{host} @dots{}
Configure the development tools to run on the specified @var{host}.

There is no convenient way to generate a list of all available hosts.
@end table

The @w{@samp{-prefix=@var{dest}}} and @w{@samp{-exec-prefix=@var{bindest}}}
options are particularly important.  If you don't specify a @var{dest}
or @var{bindest} directory, the @file{Makefile} installs binaries in
subdirectories of @file{/usr/local}.  These options are important
because the @var{dest} and @var{bindest} directories are used for
several purposes:

@enumerate
@item
@var{bindest} is the directory where binaries are installed.

@item
@var{bindest} is built into the compiler itself for the
locations of @sc{gcc} specific include files, the locations of @sc{gcc}
subprograms, and the location of the @sc{gcc} specific library
@file{libgcc.a}.

@item
@var{dest} is compiled into @code{info} as the default directory
for the documentation.

@end enumerate

@node Compilation, Installation, configure Options, Rebuilding
@unnumberedsec Compilation

After you've run @code{configure} (which writes the final
@file{Makefile} in each directory), compilation is straightforward.
To compile all the programs in the Developer's Kit, run:

@cartouche
@example
@b{make}
@end example
@end cartouche

The overall @file{Makefile} propagates the value of the @code{CC}
variable explicitly, so that you can easily control the compiler used in
this step.  @code{CFLAGS} is treated the same way.  For instance, to
build the compiler a second time, using @sc{gcc} to compile itself
(after building and installing it in the alternate directory
@file{/local/gnu}), you might use

@cartouche
@example
@b{make CC=/local/gnu/H-sun4/bin/gcc CFLAGS=-O}
@end example
@end cartouche

The conventional targets @samp{all}, @samp{install}, and @samp{clean}
are supported at all levels of @file{Makefile}.  Other targets are
supported as well, as appropriate in each directory; please read the
individual @file{Makefile} for details.  Each @file{Makefile} in the
source directories includes ample comments to help you read it.  If you
are not familiar with @code{make}, refer to @ref{Overview,,Overview of
@code{make}, make.info, GNU Make: A Program for Directing
Recompilation}.

@node Installation,  , Compilation, Rebuilding
@unnumberedsec Installation

Whether you configure an alternative path using @code{-prefix}, or you
use the default installation path @file{/usr/local}, you can install the
software by executing:

@cartouche
@example
@b{make install}
@end example
@end cartouche

@node Removing, Cygnus-FSF, Rebuilding, Top
@unnumbered Removing Parts of the Developer's Kit
You can use the @code{pkgrm} command to remove either part of this
release from where @code{pkgadd} installed it.

To do this, call @code{pkgrm} with either or both of the arguments
@samp{GNUDEVTkit} (to remove binaries) or @samp{GNUDEVTsrc} (to remove
source).  For example, suppose you never look at the source, and are
running short of disk space; you can remove the source, while leaving
the rest of the Progressive Release undisturbed, as follows:

@cartouche
@example
eg# @b{/usr/sbin/pkgrm GNUDEVTsrc}
@end example
@end cartouche

To remove the complete Progressive Release of the Developer's Kit from
your system (if, eventually, you no longer want it), specify both
package names as arguments to @code{pkgrm}

@node Cygnus-FSF, Cygnus-Support, Removing, Top
@unnumbered Cygnus Releases and the FSF

Most of the tools in this Developer's Kit are originally from the Free
Software Foundation (FSF).  You can get versions of all these tools
from the FSF as well as from Cygnus.  In general, Cygnus Progressive
Releases add to FSF software in the following ways:
@c UPDATE! more differences bet Cygnus/FSF releases?

@itemize @bullet
@item
Commercial support is available.  Cygnus adds value to FSF releases in
large measure by offering outstanding support services.
@item
Coordination.  The tools in your Developer's Kit are certified to work
together; you need not worry about tools being out of step with each other.
@item
Bug fixes.  A Progressive Release includes many fixes, already integrated
into the programs.  Cygnus repairs bugs discovered during testing, and
also tracks and includes bug fixes developed for other Cygnus customers
or distributed over the Internet.
@item
Bug reporting.  Cygnus releases include the tool @code{send_pr}, which
you can use to make sure your problem reports receive prompt attention,
and are also incorporated in our future tests.
@item
Documentation.  Cygnus revises and adds to available FSF
documentation to give you better descriptions of all the software tools.
@item
Stability.  Cygnus tests (and uses) all the programs it releases.
@end itemize

@c FIXME! If we can say something about this, remove @ignore/@end ignore
@c        and fill in below:
@ignore
This particular Cygnus Progressive release differs from the nearest
corresponding FSF distributions in these important details:

FILL IN HERE!

@end ignore

@node Cygnus-Support,  , Cygnus-FSF, Top
@unnumbered About Cygnus Support

Cygnus Support was founded in 1989 to provide commercial support for
free software.  Cygnus supplies products and services that benefit
advanced development groups by allowing them to use state-of-the-art
tools without having to maintain them.  With Cygnus Support, sites that
once were forced to do their own tool support can recover that valuable
staff time.  Former users of proprietary software now may choose
supported free software, combining the advantages of both worlds.

Free software is faster, more powerful, and more portable than its
proprietary counterparts.  It evolves faster because users who want to
make improvements are free to do so.  Cygnus tracks these
improvements and integrates them into tested, stable versions ready
for commercial use, then backs this software with comprehensive
support.

With Cygnus Support as your partner, you will have the software and
the support you need to meet your business objectives.  Cygnus
is intimately familiar with this software from extensive experience
using, debugging, and implementing it.  You get direct access to the
most qualified support people: the authors of the software.

We provide ``vintage'' releases---the most stable versions, which have
been though even more extensive use and testing---or up-to-the minute
``progressive'' releases, for those who need the very latest version.

Because all our improvements are also free software, you can
distribute them widely within your organization, or to your customers,
without extra cost.

@sp 4

@display
Cygnus Support
814 University Avenue
Palo Alto, CA 94301, USA

+1 415 322 3811
hotline: +1 415 322 7836
email: @code{info@@cygnus.com}
fax: +1 415 322 3270
@end display

@bye
OpenPOWER on IntegriCloud