Add information about setting up media to use the multi-volume support

in sysinstall.

Reviewed by:	ru
This commit is contained in:
Murray Stokely 2002-06-05 00:34:58 +00:00
parent 6a95e08f2f
commit 2a295fdf9d
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=97840
2 changed files with 120 additions and 0 deletions

View file

@ -919,6 +919,66 @@ except that
.Ar _ftpPath
is not used.
.El
.Sh DISTRIBUTION MEDIA
The following files can be used to affect the operation of
.Nm
when used during initial system installation.
.Bl -tag -width ".Pa packages/INDEX"
.It Pa cdrom.inf
A text file of properties, listed one per line, that describe the
contents of the media in use.
The syntax for each line is simply
.Dq Ar property No = Ar value .
Currently, only the following properties are recognized.
.Bl -tag -width ".Va CD_MACHINE_ARCH"
.It Va CD_VERSION
This property should be set to the
.Fx
version on the current
media volume.
For example,
.Dq Li "CD_VERSION = 4.6" .
.It Va CD_MACHINE_ARCH
This property should be set to the architecture of the contents on
this volume.
This property is normally only used with
.Fx
products that contain
CDs for different architectures, to provide better error messages if
users try to install Alpha packages on an i386 machine.
For example,
.Dq Li "CD_MACHINE_ARCH = alpha" .
.It Va VOLUME
In a multi-volume collection (such as the
.Fx
4-CD set), the
.Pa ports/INDEX
file on each disc should contain the full package index for the set.
The last field of the
.Pa INDEX
file denotes which volume the package
appears on, and the
.Va VOLUME
property here defines the volume ID of the current disc.
.El
.It Pa packages/INDEX
The package index file.
Each package is listed on a separate line with additional meta-data
such as the required dependencies.
This index is generated by
.Dq Li "make index"
from the
.Xr ports 7
collection.
When multi-volume support is enabled, an additional field should be
added to each line indicating which media volume contains the given
package.
.El
.Pp
For information about building a full release of
.Fx ,
please see
.Xr release 7 .
.Sh FILES
This utility may edit the contents of
.Pa /etc/rc.conf ,

View file

@ -919,6 +919,66 @@ except that
.Ar _ftpPath
is not used.
.El
.Sh DISTRIBUTION MEDIA
The following files can be used to affect the operation of
.Nm
when used during initial system installation.
.Bl -tag -width ".Pa packages/INDEX"
.It Pa cdrom.inf
A text file of properties, listed one per line, that describe the
contents of the media in use.
The syntax for each line is simply
.Dq Ar property No = Ar value .
Currently, only the following properties are recognized.
.Bl -tag -width ".Va CD_MACHINE_ARCH"
.It Va CD_VERSION
This property should be set to the
.Fx
version on the current
media volume.
For example,
.Dq Li "CD_VERSION = 4.6" .
.It Va CD_MACHINE_ARCH
This property should be set to the architecture of the contents on
this volume.
This property is normally only used with
.Fx
products that contain
CDs for different architectures, to provide better error messages if
users try to install Alpha packages on an i386 machine.
For example,
.Dq Li "CD_MACHINE_ARCH = alpha" .
.It Va VOLUME
In a multi-volume collection (such as the
.Fx
4-CD set), the
.Pa ports/INDEX
file on each disc should contain the full package index for the set.
The last field of the
.Pa INDEX
file denotes which volume the package
appears on, and the
.Va VOLUME
property here defines the volume ID of the current disc.
.El
.It Pa packages/INDEX
The package index file.
Each package is listed on a separate line with additional meta-data
such as the required dependencies.
This index is generated by
.Dq Li "make index"
from the
.Xr ports 7
collection.
When multi-volume support is enabled, an additional field should be
added to each line indicating which media volume contains the given
package.
.El
.Pp
For information about building a full release of
.Fx ,
please see
.Xr release 7 .
.Sh FILES
This utility may edit the contents of
.Pa /etc/rc.conf ,