Required Options
|
-n archive_name
|
The value of this flag is the name of the archive. The archive_name you specify is the value of the content_name keyword.
|
Option for Compression
|
-c
|
Compresses the archive by using compress(1).
|
Options for Directories and Sizes
|
-R root
|
Creates the archive from the file system tree that is rooted at root. If you do not specify this option, flar create creates
an archive from a file system that is rooted at /.
|
-S
|
Omits sizing information in the archive.
|
-H
|
Does not generate the hash identifier.
|
Options for Creating a Differential Archive
|
-A unchanged_master_image_dir
|
Creates a differential archive by comparing a new system image with the image
that is specified by the unchanged_master_image_dir argument.
By default, the new system image is root (/). You can change
the default with the -R option. unchanged_master_image_dir is a directory where the unchanged master system image is stored or
mounted through UFS, NFS, or lumount.
You can modify the effects of file selection for a differential archive by using
the options for contents selection described in the next section of the table.
|
-M
|
Excludes the manifest file. When you use this option, no validation occurs on
the differential archive. When creating a differential archive, flar create creates a long list of the files in the system that are unchanged, are
changed, and are to be deleted from the archive. This list is stored in the manifest
section of the archive. When the differential archive is deployed, the software uses
this list to perform a file-by-file check, ensuring the integrity of the clone system.
Use of this option avoids such a check and saves the space that is used by the manifest
section in a differential archive. However, you must consider the savings in time
and disk space against the loss of an integrity check upon installation. Because no
validation occurs, avoid using this option.
|
Options for Contents Selection
|
Caution – Use the flar create file-exclusion options with
caution. If you exclude some directories, others that you were unaware of might be
left in the archive, such as system configuration files. The system would then be
inconsistent and the installation would not work. Excluding directories and files
is best used with data that can easily be removed without disrupting the system, such
as large data files.
|
-y include_dir/filename
|
Adds to the archive those files and directories that are specified on the command
line. This option is used when you have excluded a directory, but want to restore
individual subdirectories or files.
include_dir/filename is the name of the subdirectory
or file to be included.
|
-f list_filename
|
Adds files and directories from a list to the archive.
list_filename is the full path to a file that contains
a list. The contents of the file are added to the file list unless -F is
specified.
-
The list_filename file must contain one
file per line.
-
If you specify a file system with -R root, the path to each file must be relative to the alternate root directory or an absolute path.
-
If filename is “-”, flar create reads standard input as the list of files. When you use the
value “-”, the archive size is not calculated.
|
-F
|
Uses only the files in -f list_filename to
create the archive. This option makes the -f list_filename the absolute list, rather than a list that is appended to the normal
file list.
|
-x exclude_dir/filename
|
Excludes files and directories from the archive. These files and directories
are specified at the command line. You can use multiple instances of this option to
exclude more than one file or directory.
exclude_dir/filename is the name of the directory
or file to be excluded.
|
-X list_filename
|
Excludes a list of files or directories from the archive.
list_filename is the full path to a file that contains
the list.
-
The list_filename file must contain one
file per line.
-
If you specify a file system with -R root, the path to each file must be relative to the alternate root directory or an absolute path.
-
If list_filename is “-”, flar create reads standard input as the list of files. When you use the
value “-”, the archive size is not calculated.
|
-z list_filename
|
Excludes or includes a list of files or directories from the archive. Each file
or directory in the list is noted with a plus “+” or minus “-”.
A plus indicates an included file or directory and the minus indicates an excluded
file or directory.
list_filename is the full path to a file that contains
the list.
-
The list_filename file must contain one
file per line.
-
If you specify a file system with -R root, the path to each file must be relative to the alternate root directory or an absolute path.
|
-I
|
Override the integrity check. To prevent you from excluding important system
files from an archive, flar create runs an integrity check. This
check examines all files that are registered in a system package database and stops
archive creation if any of them are excluded. Use of this option overrides this integrity
check. Therefore, avoid the use of the -I option.
|
Options Used With User-Defined Sections
|
-u section
|
Includes section as a user-defined section. To include
more than one user-defined section, section must be a space-separated
list of section names.
|
-d dir
|
Retrieves the section file that is specified with -u from dir.
|
Options Used With Tape Archives
|
-t
|
Creates an archive on a tape device. The filename argument
is the name of the tape device.
|
-p posn
|
Use only with the -t option. Specifies the position on the tape
device for flar create to store the archive. If you do not use
this option, flar create places the archive at the current position
of the tape.
|
-b blocksize
|
Specifies the block size flar create uses when creating the
archive. If you do not specify a block size, flar create uses
the default block size of 64 KB.
|
Options for Archive Identification
These keywords and values appear in the identification section of the archive.
|
-U key=val
|
Includes user-defined keywords and values in the Archive Identification section.
|
-i date
|
Uses date as the value for the creation_date keyword. If you do not specify a date, flar create uses
the current system time and date.
|
-m master
|
Uses master as the name of the master system on which
you created the archive. master is the value for the creation_master keyword. If you do not specify master, flar create uses the system name that is reported by uname -n.
|
-e descr
|
Uses descr for the value of the content_description keyword. You cannot use this option when you use the -E option.
|
-E descr_file
|
Retrieves the value for the content_description keyword
from the descr_file file. You cannot use this option
when you use the -e option.
|
-a author
|
Uses author as the author name in the Archive Identification
section. author is the value for the content_author keyword. If you do not specify an author, flar create does
not include the content_author keyword in the Archive Identification
section.
|
-T type
|
Uses type as the value for the content_type keyword. type is user defined. If you do not
specify a type, flar create does not include the content_type keyword.
|