diff --git a/xCAT-buildkit/pods/man1/buildkit.1.pod b/xCAT-buildkit/pods/man1/buildkit.1.pod index 464fa124d..79e30a54c 100644 --- a/xCAT-buildkit/pods/man1/buildkit.1.pod +++ b/xCAT-buildkit/pods/man1/buildkit.1.pod @@ -20,9 +20,23 @@ The B command provides a collection of utilities that may be used to p You will need to run the B command several times with different subcommands to step through the process of building a kit: -The following example illustrates the basic process for building a new Kit. It assumes that each subcommand will operate in the current working directory. You could specify a different location by using the "B<-l>|B<--kitloc> I" option. +By default the B subcommands will operate in the current working directory, (ie. look for files, create directories etc.). You could specify a different location by using the "B<-l | --kitloc> I" option. -In this example we are building a Kit named "mytstkit". +The kit I is the full path name of the directory that contains the kit files, including the kit basename. You would use the same location value for all the buildkit subcommands. + +For example, to create a new kit named "prodkit" in the directory /home/mykits/ I run: + +B + +B + +or + +B + +In both cases the /home/mykits/prodkit directory is created and the inital files for the kit are created in that directory. + +The following example illustrates the basic process for building a new Kit. In this example we are building a Kit named "mytstkit". =over 4 @@ -121,31 +135,31 @@ Command version. =item B I -Creates a new kit build directory structure for kit I in the current directory. The sample kit files from /opt/xcat/share/xcat/kits/kit_template are copied over, and the /I/buildkit.conf is modified for the specified I. +Creates a new kit build directory structure for kit I using the location specified on the command line or the current directory. The sample kit files from /opt/xcat/share/xcat/kits/kit_template are copied over, and the buildkit.conf file is modified for the specified I. =item B -Reads the buildkit.conf file from the current directory, verifies that the file syntax is correct and that all specified files exist. +Reads the buildkit.conf file, verifies that the file syntax is correct and that all specified files exist. =item B -Reads the buildkit.conf file from the current directory, lists all Kit package repositories listed in the file, and reports the build status for each repository. +Reads the buildkit.conf file, lists all Kit package repositories listed in the file, and reports the build status for each repository. =item B {I | B} -Reads the buildkit.conf file from the current directory, and builds the specified Kit package repository. The built packages are placed in the directory /build/kit_repodir/I. If B is specified, all kit repositories are built. +Reads the buildkit.conf file, and builds the specified Kit package repository. The built packages are placed in the directory /build/kit_repodir/I. If B is specified, all kit repositories are built. =item B {I | B} -Reads the buildkit.conf file from the current directory, and deletes all the package files and package meta data files from the /build/kit_repodir/I directory. If B is specified, all kit repository files are deleted. +Reads the buildkit.conf file, and deletes all the package files and package meta data files from the /build/kit_repodir/I directory. If B is specified, all kit repository files are deleted. =item B -Reads the buildkit.conf file from the current directory, validates that all kit repositories have been built, and builds the Kit tar file /I.tar.bz2. +Reads the buildkit.conf file, validates that all kit repositories have been built, and builds the Kit tar file /I.tar.bz2. =item B -Reads the buildkit.conf file from the current directory, deletes the Kit tar /I.tar.bz2, and deletes all files in the build work directory /build/I. +Reads the buildkit.conf file, deletes the Kit tar /I.tar.bz2, and deletes all files in the build work directory /build/I. =item B @@ -155,7 +169,7 @@ Equivalent to running B and B. I {B<-p> | B<--pkgdir> I} [B<-k> | B<--kitversion> I] [B<-r> | B<--kitrelease> I] -Add product package rpms to a previously built kit tar file. This is used for incomplete product kits that are built and shipped separately from the product packages, and are identified with a I name of I.B. Optionally, change the kit release and version values when building the new kit tarfile. If kitcomponent version and/or release values are defaulted to the kit values, those will also be changed and new kitcomponent rpms will be built. If kit or kitcomponent scripts, plugins, or other files specify name, release, or version substitution strings, these will all be replaced with the new values when built into the new complete kit tarfile I/I.B. +Add product package rpms to a previously built kit tar file. This is used for partial product kits that are built and shipped separately from the product packages, and are identified with a I name of I.B. Optionally, change the kit release and version values when building the new kit tarfile. If kitcomponent version and/or release values are defaulted to the kit values, those will also be changed and new kitcomponent rpms will be built. If kit or kitcomponent scripts, plugins, or other files specify name, release, or version substitution strings, these will all be replaced with the new values when built into the new complete kit tarfile I/I.B. =back