lsvol Reference

Name

lsvol -- list volume attributes

Synopsis

lsvol [-h] [-d] [-r] [-c] volume

Description

The lsvol utility displays various attributes and structures associated with a volume image. If no options are specified, lsvol displays the volume header of the designated volume.

The following options are available:

-h	Display volume header. The volume header identifies critical information about the CapROS volume, including the native page size, the locations of the primary and optional secondary division tables, and the boot flags. The currently supported volume header flags and their meanings are: BOOT Volume is bootable, and contains a valid bootstrap image. IPL Volume is an IPL volume. It contains no checkpoint area. This flag is obsolete and may be dropped in future system versions. RAMDISK Volume should be loaded into memory as a ramdisk. COMPRESSED Volume image following bootstrap is compressed. Compressed images must be marked as ramdisk images.
-d	Show division table. The division table shows the locations on the volumes of the various divisions. The fields in the division table entry are: Start Starting sector number of the division. End Bounding sector number (i.e. top plus one) of the division. Size Size of the division in sectors. Type Type of the division (see below). If the division is of type Object, Log, or Kernel, a range of OIDs will also be displayed. For object and kernel divisions, this is the range of object identifiers contained in the division. For log divisions, this is the range of log locations contained in the division. There are several valid division types: Boot The division holding the bootstrap code. Always starts at sector zero. DivTbl The division holding the division table. There may be up to two DivTbl divisions. Spare A division holding spare sectors for use in bad block relocation. This is not currently used. Object A division that holds nodes or pages. Kernel A division that holds the bootable kernel image. This division is formatted just like an object division, and the kernel is layed out in consecutive pages within the division. The kernel division is mounted by CapROS as an object division. Log A division containing space used by the checkpoint log. FailStart The failstart entry is actually not a division at all. It provides a means to boot a recovery or startup application on a system image that does not have a checkpoint area (at all). This facility exists primarily to enable bootstrap floppies to go without a checkpoint area.
-r	Show reserve table. This option is mostly of use for kernel development.
-c	Show checkpoint directory. This option is mostly of use for kernel development.