Use the Web Start Flash commands to create and manage Web Start Flash archives.
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. |
The flar command allows you to administer archives. With the flar command you can accomplish the following tasks.
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:info [-l] [-k keyword] [-t [-p posn] [-b blocksize]] filename
Table 20–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. |
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:split[-d dir] [-u section] [-f archive] [-S section] [-t [-p posn] [-b blocksize]] filename
Table 20–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 copies the section named section from the archive. |
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:combine [-d dir] [-u section] [-t [-p posn] [-b blocksize]] filename
No validation is performed on any of the sections. In particular, no fields in the Archive Identification section are validated or updated.
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. |