diff --git a/xCAT-client/pods/man8/copycds.8.pod b/xCAT-client/pods/man8/copycds.8.pod index 1b63ed7b0..124fbfc3b 100644 --- a/xCAT-client/pods/man8/copycds.8.pod +++ b/xCAT-client/pods/man8/copycds.8.pod @@ -5,18 +5,17 @@ B - Copies Linux distributions and service levels from CDs/DVDs to inst =head1 SYNOPSIS -B [{B<-n|--name|--osver>}=I] [{B<-a|--arch>}=I] {I|I} ... +B [{B<-n|--name|--osver>}=I] [{B<-a|--arch>}=I] [{B<-p|--path>}=I] {I|I} ... + +B [B<-i>|B<--inspection>] {I|I} B [B<-h>|B<--help>] =head1 DESCRIPTION -The B command copies all contents of Distribution CDs/DVDs or Service Pack CDs/DVDs to the install directory as -designated in the B table attribute: B. The B command can copy from one or more ISO files, -or from the CD/DVD device path. If xCAT doesn't recognize the signature of the CD/DVD (e.g. in the .discinfo -file), you must specify the -n and -a options. This is sometimes the case for distros that have very -recently been released, and the xCAT code hasn't been updated for it yet. +The B command copies all contents of Distribution CDs/DVDs or Service Pack CDs/DVDs to a destination directory. The destination directory is specified by -p option. If no path is specified, the default destination directory will be formed from the B site attribute and the distro name and architecture, for example: /install/sles11.2/ppc64. The B command can copy from one or more ISO files, or CD/DVD device path. You can specify -i or --inspection option to check whether the CDs/DVDs can be recognized by xCAT. If recognized, the distribution name, architecture and the disc no (the disc sequence number of CDs/DVDs in multi-disk distribution) of the CD/DVD is displayed. If xCAT doesn't recognize the CD/DVD, you must specify the -n and -a options. This is sometimes the case for distros that have very recently been released, and the xCAT code hasn't been updated for it yet. + =head1 OPTIONS @@ -27,12 +26,30 @@ recently been released, and the xCAT code hasn't been updated for it yet. The linux distro name and version that the ISO/DVD contains. Examples: rhels5.3, centos5.1, fedora9. -=item {B<-a|--arch>}=I] +=item {B<-a|--arch>}=I The architecture of the linux distro on the ISO/DVD. Examples: x86, x86_64, ppc64. +=item {B<-p|--path>}=I + +The destination directory to which the contents of ISO/DVD will be copied. When this option is not specified, the default destination directory will be formed from the B site attribute and the distro name and architecture, for example: /install/sles11.2/ppc64. This option only supports distributions of sles and redhat. + +=item {B<-i|--inspection>} + +Check whether xCAT can recognize the CD/DVDs in the argument list without any disc copy, display the os distribution name, architecture and disc no of each recognized CD/DVD. This option only supports distributions of sles and redhat. + =back +=head1 RETURN VALUE + +Zero: + The command completed successfully. + For the --inspection option, the ISO/DVD have been recognized successfully + +Nonzero: + An Error has occurred. + For the --inspection option, the ISO/DVD cannot be recognized + =head1 EXAMPLES @@ -46,9 +63,9 @@ B =item * -To copy the RPMs from a physical DVD: +To copy the RPMs from a physical DVD to /depot/kits/3 directory: -B +B =item * @@ -56,9 +73,34 @@ To copy the RPMs from a DVD ISO of a very recently released distro: B +=item * + +To check whether a DVD ISO can be recognized by xCAT and display the recognized disc info: + +B + =back +=head1 NOTES +1. The B<-p> and B<-i> options currently only support distributions of sles and redhat. + +2. The output format of copycds --inspection is: + + OS Image: + DISTNAME: + ARCH: + DISCNO: + +As a example: + + OS Image:/media/RHEL/6.2/RHEL6.2-20111117.0-Server-ppc64-DVD1.iso + DISTNAME:rhels6.2 + ARCH:ppc64 + DISCNO:1 + +For the attributes failed to be recognized, the value will be blank. + =head1 SEE ALSO L, L, L