From c44b295315ac8bc4064a6fd8c2333fffc421d537 Mon Sep 17 00:00:00 2001 From: Roland Pesch Date: Mon, 25 May 1992 20:42:53 +0000 Subject: [PATCH] Draft Solaris install notes. Checked into "devo" temporarily; will probably need to move to another repository. Feel free to move it, but *please* move the entire underlying RCS file, not just the HEAD version (unless, of course, you move it while there's just this version checked in). --- solaris-inst.texinfo | 1709 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 1709 insertions(+) create mode 100755 solaris-inst.texinfo diff --git a/solaris-inst.texinfo b/solaris-inst.texinfo new file mode 100755 index 00000000000..45b24a9b58a --- /dev/null +++ b/solaris-inst.texinfo @@ -0,0 +1,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 -- 2.30.2