Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
System Administration Commandsflarcreate(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. Following archive creation, use the flar(1M) command to administer a flash archive.

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 specified (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.
-H
Do not generate hash identifier.
-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.
-U key=val...
Include the user-defined keyword(s) and values in the archive identification section.
-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.

Use the following options with user-defined sections.

-d dir
Retrieve the section file specified with -u from dir.
-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 flash_archive(4).

Use the following options with tape archives.

-b blocksize
The block size to be used when creating the archive. If not specified, a default block size of 64K is used.
-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.
-t
Create an archive on a tape device. The outfile operand (see OPERANDS) is assumed to be the name of the tape device.

The following options are used for archive identification.

-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.
-e descr
The description to be included in the archive as the value of the content_description archive identification 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.
-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 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.
-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.
-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:

archive
Path to the flash archive.
outfile
Name of the tape device if the -t option is used.

EXIT STATUS

 

The following exit values are returned:

0
Successful completion.
>0
An error occurred.

ATTRIBUTES

 

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWinst

SEE ALSO

 

flar(1M), flash_archive(4), attributes(5)


SunOS 5.9Go To TopLast Changed 16 Jan 2002

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.