UPDATE(4)

NAME

update − update-media format

DESCRIPTION

Update media consists of a simple tar(1) archive with a few leading information files used by update(1M) plus specially-crafted file paths that allow files to be grouped into filesets. The following is intended as an aid in interpreting update media; not as a design guide for building your own.

Information Files

The information files contain ASCII text and include:

system/INDEX This file starts with a header line describing the general title of the update media and the number of this media unit (such as in multiple-tape sets). The rest of the file is a list of fileset names, the names of the partitions to which the filesets belong, specification of dependent filesets, and the media (tape) number on which each fileset is found. On multiple-tape update media, the INDEX file on each tape is identical to that on all other tapes except for the media unit number in the header line.

system/INFO This file has essentially two parts. The first part lists the filesets along with a description of each fileset, flags associated with each fileset (see Fileset Flags below), and the media number on which that fileset resides. This media number is ignored in deference to the media number in the INDEX file.

The second part of the file lists, for each fileset on the update media set, the files in the fileset and their sizes. On multiple-tape update media, the INFO file on each tape is identical to that on all other tapes.

system/CDFinfo This file contains a list of stand-alone file path names and one or more rules concerning each path name. The rules describe changes associated with each file when turning a standalone system into a cluster server, updating a cluster server, or adding a cnode to a clustered system. Sam(1M) and update(1M) apply these rules during such operations. Only files whose paths require changes during cluster operations appear in the CDFinfo file.

Fileset Flags

Each fileset has five flags associated with it. Their meanings are:

B Rebuild the kernel and reboot the system.

C Change of destination is not allowed for this fileset.

D Delay running of customization scripts for all filesets loaded.

H Fileset contains HP-PA (Series 800) files, as opposed to HP-MC68020 (Series 300) files.

Y Use sysrm(1M) to remove the files in the fileset before loading new ones.

The B, C, D, and Y flags are used by update(1M) and ignored by updist(1M).

In addition, the P flag appears on partition description lines only.

Path Names

On update media, path names of files other than the information files consist of their official path names with a concatenated prefix:

fileset/..

For example:

CORE/../bin/sh

These path names indicate each file’s fileset and still allow unpacking with tar relative to any directory. Unpacking an update media unit with tar rather than update creates empty directories on the system, one for each fileset on the update media. The empty directories can be removed.

Each fileset’s files appear on the media grouped together (in a contiguous sequence).

File Types

Update (tar) media support the following types of files: ordinary, directory, symbolic link, character special, block special, and FIFO. Network special files and sockets are not supported. Furthermore, update and updist do not support creation of character special, block special, and FIFO files.

EXAMPLES

To list the files on an update media unit accessed through special file /dev/rmt:

tar −tvf /dev/rmt

To study the leading information files on that update media unit:

cd /tmp
tar −xvf /dev/rmt system
more system/∗

Museum

Related Articles