2
0
mirror of https://github.com/xcat2/xcat-core.git synced 2025-05-28 06:23:26 +00:00
xcat-core/xCAT-client/pods/man1/packimage.1.pod

71 lines
1.7 KiB
Plaintext

=head1 NAME
B<packimage> - Packs the stateless image from the chroot file system.
=head1 SYNOPSIS
B<packimage [-h| --help]>
B<packimage [-v| --version]>
B<packimage> [B<-m>|B<--method> I<cpio|tar>] [B<-c>|B<--compress> I<gzip|pigz|xz>] [B<--nosyncfiles>] I<imagename>
=head1 DESCRIPTION
Packs the stateless image from the chroot file system into a file to be sent to the node for a diskless boot.
Note: For an osimage that is deployed on a cluster, running packimage will overwrite the existing rootimage file and be unavailable to the compute nodes while packimage is running.
=head1 PARAMETERS
I<imagename> specifies the name of a OS image definition to be used. The specification for the image is stored in the I<osimage> table and I<linuximage> table.
=head1 OPTIONS
B<-h> Display usage message.
B<-v> Command Version.
B<-m| --method> Archive Method (cpio,tar,squashfs, default is cpio)
B<-c| --compress> Compress Method (pigz,gzip,xz, default is pigz/gzip)
B<--nosyncfiles> Bypass of syncfiles requested, will not sync files to root image directory
=head1 RETURN VALUE
0 The command completed successfully.
1 An error has occurred.
=head1 EXAMPLES
1. To pack the osimage 'rhels7.1-x86_64-netboot-compute':
packimage rhels7.1-x86_64-netboot-compute
2. To pack the osimage 'rhels7.1-x86_64-netboot-compute' with "tar" to archive and "pigz" to compress:
packimage -m tar -c pigz rhels7.1-x86_64-netboot-compute
3. To pack the osimage 'rhels7.1-x86_64-netboot-compute' without syncing files:
packimage --nosyncfiles rhels7.1-x86_64-netboot-compute
=head1 FILES
/opt/xcat/sbin/packimage
=head1 NOTES
This command is part of the xCAT software product.
=head1 SEE ALSO
L<genimage(1)|genimage.1>