Web Start Flash Commands

Use the Web Start Flash commands to create and manage Web Start Flash archives.

`flarcreate`

Use the flarcreate command to create a Web Start Flash archive from a master machine. You can use this command when the master machine is running in multiuser or single-user mode. You can also use flarcreate when the master machine was booted from the Solaris 1 of 2 Software CD or from a Solaris net image. The master machine should be in as stable a state as possible when you create a Web Start Flash archive. The syntax of the command is:

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] [-a author] [-e descr¦-E descr_file] [-T type] path/filename

In this command line, path is the directory in which you want the archive file to be saved and filename is the name of the archive file. If you do not specify a path, flarcreate saves the archive file in the current directory.

Table 9–3 Command-Line Options for flarcreate


Option	Description
Required Options
`-n` `name`	The value of this flag is the name of the archive. The `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 rooted at root. If you do not specify this option, `flarcreate` creates an archive from a file system rooted at `/`.
`-S`	Does not include sizing information in the archive.
`-x` `exclude`	Excludes the directory `exclude` from the archive.
`-H`	Does not generate the hash identifier.
Options Used With User-Defined Sections
`-u` `section`	Includes 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 `outfile` argument is the name of the tape device.
`-p` `posn`	Uses only with the -t option. Specifies the position on the tape device for `flarcreate` to store the archive. If you do not use this option, `flarcreate` places the archive in the current position of the tape.
`-b` `blocksize`	Specifies the block size `flarcreate` uses when creating the archive. If you do not specify a block size, `flarcreate` uses the default block size of 64k.
Options for Archive Identification
`-U` `key=val`	Includes user-defined keyword(s) 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, `flarcreate` uses the current system time and date.
`-m` `master`	Uses `master` as the name of the master machine on which you created the archive for the `creation_master` keyword. If you do not specify a `master`, `flarcreate` uses the machine 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 file `descr_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. If you do not specify an author, `flarcreate` does not include an author in the Archive Identification section.
`-T` `type`	Uses `type` as the value for the `content_type` keyword. If you do not specify a type, `flarcreate` does not include the `content_type` keyword.

`flar`

The flar command allows you to administer archives. With the flar command you can accomplish the following tasks.

Extract information from an archive
Split an archive
Combine archives

Extracting Information From an Archive

Use the flar command with the -i option to get information about archives you have already created. The syntax of the command is:

flar -i [-l] [-k keyword] [-t [-p posn] [-b blocksize]] filename

Table 9–4 Command-Line Options for flar -i


Option	Description
`-k` `keyword`	Returns only the value of the keyword `keyword`.
`-l`	Lists all the files in the archive section.

Splitting Archives

The flar command with the -s option splits a Web Start Flash archive into sections. The flar command copies each section into a separate file in the current or specified directory. The files are named after the sections, for example, the archive cookie is saved in a file named cookie. You can specify that the flar command only save one section. The syntax of the command is:

flar -s [-d dir] [-u section] [-f archive] [-S section] [-t [-p posn] [-b blocksize]] filename

Table 9–5 Command-Line Options for flar -s


Option	Description
`-d` `dir`	Retrieves the sections to copy from `dir`, rather than from the current directory.
`-u` `section`	If you do not use this option, `flar` copies all sections in the current directory. If you use this option, `flar` copies the Cookie, Identification, Archive, and `section` sections. You can specify a single section name or a space-separated list of section names.
`-f` archive	Extracts the Archive section into a directory called `archive`, rather than place it in a file with the name `archive`.
`-S` `section`	Only copy the section named `section` from the archive.

Combining Archives

The flar command with the -c option creates a Web Start Flash archive from individual sections. 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 directory, the flar command uses cpio to archive it before including it in the combined archive. If the Archive Identification section specifies to compress the archive, flar compresses the contents of the newly combined archive.

flar -c [-d dir] [-u section] [-t [-p posn] [-b blocksize]] filename

Note –

No validation is performed on any of the sections. In particular, no fields in the Archive Identification section are validated or updated.

Table 9–6 Command-Line Options for flar -c


Option	Description
`-d` `dir`	Retrieves the sections to combine from `dir`, rather than from the current directory.
`-u` `section`	If you do not use this option, `flar` combines all sections in the current directory. If you use this option, `flar` combines only the Cookie, Identification, Archive, and `section` sections. You can specify a single section name or a space-separated list of section names.

Previous: Web Start Flash Keywords