SunOS man pages : flarcreate (1)
Maintenance Commands flarcreate(1M)
NAME
flarcreate - create a flash archive from a master system
SYNOPSIS
flarcreate -n name [ -R root ] [ -S ] [ -H ] [ -c ] [
-x exclude ] [ -t [ -p posn ] [ -b blocksize ] ] [ -i
date ] [ -m master ] [ -u section ... [ -d dir ] ] [ -U
key=val ... ] [ -f [ filelist | - ] [ -F ] ] [ -a author
] [ -e descr | -E descr_file ] [ -T type ] outfile
DESCRIPTION
The flarcreate command creates a flash archive from a master
system. A master system is one that contains a reference
configuration, which is a particular configuration of the
Solaris operating environment, plus optional other software.
A flash archive is an easily transportable version of the
reference configuration.
You can run flarcreate in multi- or single-user mode. You
can also use the command when the master system is booted
from the first Solaris software CD or from a Solaris net
image.
Archive creation should be performed when the master system
is in as stable a state as possible.
See flash_archive(4) for a description of the flash archive.
OPTIONS
The flarcreate command has the following general options:
-c Compress the archive using compress(1)
-f filelist
Use the contents of filelist as a list of files to
include in the archive. The files are included in
addition to the normal file list, unless -F is speci-
fied (see below). If filelist is -, the list is taken
from standard input.
-F Include only files in the list specified by -f. This
option makes -f filelist an absolute list, rather than
a list that is appended to the normal file list.
-R root
Create the archive from the filesystem tree rooted at
root. If you do not specify this option, flarcreate
creates an archive from a filesystem rooted at /.
-S Do not include sizing information in the archive.
-H Do not generate hash identifier.
SunOS 5.8 Last change: 13 Feb 2001 1
Maintenance Commands flarcreate(1M)
-x exclude
Exclude the directory exclude from the archive. Note
that the exclude directory is assumed to be relative
to the alternate root specified using -R.
-U key=val...
Include the user-defined keyword(s) and values in the
archive identification section
Use the following options with user-defined sections.
-u section ...
Included the user-defined section located in the file
section in the archive. section must be a blank-
separated list of section names as described in
flar(1M).
-d dir
Retrieve the section file specified with -u from dir.
Use the following options with tape archives.
-t Create an archive on a tape device. The outfile
operand (see OPERANDS) is assumed to be the name of
the tape device.
-p posn
Used only with -t. Specifies the position on the tape
device where the archive should be created. If not
specified, the current position of the tape device is
used.
-b blocksize
The block size to be used when creating the archive.
If not specified, a default block size of 64K is used.
The following options are used for archive identification.
-n name
This option is required if you are using flarcreate
for archive identification. The value of name is used
to identify the archive. It is also used as the value
of the content_name archive identification flag.
-i date
By default, the value for the creation_date field in
the identification section is generated automatically,
based on the current system time and date. If you
specify the -i option, date is used instead.
-m master
By default, the value for the creation_master field in
SunOS 5.8 Last change: 13 Feb 2001 2
Maintenance Commands flarcreate(1M)
the identification section is the name of the system
on which you run flarcreate, as reported by uname -n.
If you specify -m, master is used instead.
-e descr
The description to be included in the archive as the
value of the content_description archive identifica-
tion key. This option is incompatible with -E.
-E descr_file
The description to be used as the value of the archive
identification content_description key is retrieved
from the file descr_file. This option is incompatible
with -e.
-a author
author is used to provide an author name for the
archive identification section. If you do not specify
-a, no author name is included in the identification
section.
-T type
Content type included in the archive as the value of
the content_type archive identification key. If you do
not specify -T, the content_type keyword is not
included.
OPERANDS
The following operands are supported:
outfile
Name of the tape device if the -t option is used. Oth-
erwise, the path to the flash archive.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWinst |
|_____________________________|_____________________________|
SunOS 5.8 Last change: 13 Feb 2001 3
Maintenance Commands flarcreate(1M)
SEE ALSO
flar(1M), flash_archive(4), attributes(5)
SunOS 5.8 Last change: 13 Feb 2001 4
|
 |
|
|
