Date: Tue, 22 Jan 2013 15:26:19 +0000 (UTC) From: Nathan Whitehorn <nwhitehorn@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r245792 - head/usr.sbin/bsdinstall Message-ID: <201301221526.r0MFQJ50010241@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: nwhitehorn Date: Tue Jan 22 15:26:19 2013 New Revision: 245792 URL: http://svnweb.freebsd.org/changeset/base/245792 Log: Improve documentation of BSDINSTALL_DISTSITE and mdoc. Modified: head/usr.sbin/bsdinstall/bsdinstall.8 Modified: head/usr.sbin/bsdinstall/bsdinstall.8 ============================================================================== --- head/usr.sbin/bsdinstall/bsdinstall.8 Tue Jan 22 12:40:00 2013 (r245791) +++ head/usr.sbin/bsdinstall/bsdinstall.8 Tue Jan 22 15:26:19 2013 (r245792) @@ -120,7 +120,9 @@ but non-interactively according to the d .Ar parameters . Each disk setup is specified by a three-part argument: .Pp -.Ar disk [scheme] [{partitions}] +.Ar disk +.Op Ar scheme +.Op Ar {partitions} .Pp Multiple disk setups are separated by semicolons. The .Ar disk @@ -141,7 +143,9 @@ argument is also optional and specifies It consists of a comma-separated list of partitions to create enclosed in curly braces. Each partition declaration takes the form .Pp -.Ar size type [mount point] +.Ar size +.Ar type +.Op Ar mount point .Pp .Ar size specifies the partition size to create in bytes (K, M, and G suffixes @@ -209,13 +213,27 @@ process. Many are used internally during default values for most installation scenarios. Others are set by various interactive user prompts, and can be usefully overridden when making scripted or customized installers. -.Bl -tag -width ".Ev BSDINSTALL_DISTDIR" +.Bl -tag -width ".Ev BSDINSTALL_DISTSITE" .It Ev DISTRIBUTIONS The set of distributions to install (e.g. "base kernel ports"). Default: none .It Ev BSDINSTALL_DISTDIR The directory in which the distribution files can be found (or to which they should be downloaded). Default: .Pa /usr/freebsd-dist +.It Ev BSDINSTALL_DISTSITE +URL from which the distribution files should be downloaded if they are not +already present in the directory defined by +.Ev BSDINSTALL_DISTDIR . +This should be a full path to the files, including architecture and release +names. Most targets (e.g. +.Cm auto +and +.Cm jail ) +that prompt for a +.Fx +mirror will skip that step if this variable is already defined in the +environment. Example: +.Pa ftp://ftp.freebsd.org/pub/FreeBSD/releases/powerpc/powerpc64/9.1-RELEASE .It Ev BSDINSTALL_CHROOT The directory into which the distribution files should be unpacked and the directory at which the root file system of the new system should be mounted. @@ -286,8 +304,9 @@ which is passed to the .Cm scriptedpart target to control disk setup. .Ss SETUP SCRIPT -Following the preamble is a shell script, beginning with a #! declaration. -This script will be run at the end of the installation process inside a +Following the preamble is an optional shell script, beginning with a #! +declaration. This script will be run at the end of the installation process +inside a .Xr chroot 8 environment in the newly installed system and can be used to set up configuration files, install packages, etc. Note that newly configured
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201301221526.r0MFQJ50010241>