SunOS man pages : flar (1)
Maintenance Commands flar(1M)
NAME
flar - administer flash archives
SYNOPSIS
flar -i [ -l ] [ -k keyword ] [ -t [ -p posn ] [ -b
blocksize ] ] archive
flar -c [ -d dir ] [ -u section ] [ -t [ -p posn ] [ -b
blocksize ] ] archive
flar -s [ -d dir ] [ -u section ] [ -f ] [ -S section ]
[ -t [ -p posn ] [ -b blocksize ] ] archive
DESCRIPTION
The flar command is used to administer flash archives. A
flash archive is an easily transportable version of a refer-
ence configuration of the Solaris operating environment,
plus optional other software. Such an archive is used for
the rapid installation of Solaris on large numbers of
machines.
The flar command includes subcommands for extracting infor-
mation, splitting archives, and combining them. Subcommands
are indicated by the first option in a flar command line.
These options are as follows:
-i Extract information on an archive. This subcom-
mand is analogous to pkginfo.
-s Split an archive into one file for each section
of the archive. Each section is copied into a
separate file in dir, if dir is specified (see -d
option below), or the current directory if it is
not. The files resulting from the split are named
after the sections. The archive cookie is stored
in a file named cookie. If section is specified
(see -u option below), only the named section is
copied.
-c Combine the individual sections that make up an
archive into the archive. If dir is specified
(see -d option below), the sections will be gath-
ered from dir; otherwise, they will be gathered
from the current directory. Each section is
assumed to be in a separate file, the names of
which are the section names. At a minimum, the
archive cookie (cookie), archive identification
(identification), and archive files (archive)
sections must be present. If archive is a direc-
tory, its contents are archived using cpio prior
to inclusion in the archive. If so specified in
the identification section, the contents are
SunOS 5.8 Last change: 8 Feb 2001 1
Maintenance Commands flar(1M)
compressed.
Note that no validation is performed on any of
the sections. In particular, no fields in the
identification section are validated or updated.
See flash_archive(4) for a description of the
archive sections.
The options for each subcommand are described below.
OPTIONS
The options for flar -i (extract info) subcommand are as
follows:
-k keyword
Only the value of the keyword keyword is returned.
-l List all files in the archive. Does not process con-
tent from any sections other than the archive section.
The following are flar -i options used with tape archives:
-t The archive to be analyzed is located on a tape dev-
ice. The path to the device is specified by outfile
(see OPERANDS).
-p posn
Specifies the position on the tape device where the
archive should be created. If not specified, the
current position of the tape device is examined.
-b blocksize
The block size to be used when creating the archive.
If not specified, a default block size of 64K is used.
The options for flar -s and -c (split and combine archives)
subcommands are as follows:
-u section
Appends section to the list of sections to be
included. The default list includes the cookie, iden-
tification, and archive sections. section can be a
single section name or a space-separated list of sec-
tion names.
-d dir
Retrieve sections from dir, rather than from the
current directory.
-f (Used with -s only.) Extract the archive section into
directory called archive, rather than placing it in a
SunOS 5.8 Last change: 8 Feb 2001 2
Maintenance Commands flar(1M)
file of the same name as the section.
-S section
(Used with -s only.) Extract only the section named
section from the archive.
The following options are used with tape archives (with both
-c and -s):
-t Create an archive on or read an archive from 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.
OPERANDS
The following operand is supported:
outfile
Path to tape device if the -t option was used. Other-
wise, the path to a flash archive.
EXIT STATUS
The following exit values are returned for the -c and -s
subcommands:
0 Successful completion.
>0 An error occurred.
The following exit values are returned for the -i subcom-
mand:
0 Successful completion.
1 Command failed. If the -k option is used and the
requested keyword is not found, flar returns 2.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.8 Last change: 8 Feb 2001 3
Maintenance Commands flar(1M)
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWinst |
|_____________________________|_____________________________|
SEE ALSO
flarcreate(1M), flash_archive(4), attributes(5)
SunOS 5.8 Last change: 8 Feb 2001 4
|
 |
|
|
