flarcreate (Solaris 8 Advanced Installation Guide)

Solaris 8 Advanced Installation Guide

`flarcreate`

Use the flarcreate command to create a Web Start Flash archive from a master system. You can use this command when the master system is running in multiuser or single-user mode. You can also use flarcreate when the master system was booted from the Solaris 8 DVD, the Solaris 8 Software 1 of 2 CD or from an image of the Solaris 8 Software and Solaris 8 Languages CDs. The master system 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 [-u section [-d dir]] [-f file_list] [-F] [-U key=val] master] [-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 20–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 that is rooted at root. If you do not specify this option, `flarcreate` creates an archive from a file system that is rooted at `/`.
`-S`	Does not include sizing information in the archive.
`-x` `exclude`	Excludes the directory `exclude` from the archive. If you specify a file system with `-R` `root`, the path to the directory `exclude` is assumed to be relative to `root`.
`-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 `filename` argument is the name of the tape device.
`-p` `posn`	Use 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 Specifying Files
`-f` `file_list`	Adds the files in the file `file_list` to the archive. The `file_list` file must contain one file per line. The path to each file must be relative to the alternate root directory or an absolute path. If you use “-” as the value of `file_list`, `flarcreate` uses the output of `stdin` as the list of files. When you use the value “-”, the archive size is not calculated.
`-F`	Uses only the files in `file_list` to create the archive.
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 system on which you created the archive for the `creation_master` keyword. If you do not specify a `master`, `flarcreate` uses the system 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 for the `content_author` keyword. If you do not specify an author, `flarcreate` does not include the `content_author` keyword 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.