manpages.info - online man pages   

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