Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ ossize(1) — Lucid Energize 2.1

Media Vault

Software Library

Restoration Projects

Artifacts Sought

OSSIZE(1)  —  OBJECTSTORE COMMANDS

NAME

ossize − report the size of a database and its contents

SYNOPSIS

ossize [ options ] pathname

DESCRIPTION

ossize reports the size of the specified database and the size of its segments. It can also list the types used by the database and the number of stored instances of each type. Persistently allocated pointers (that is, pointer to pointers, such as new(db) thing∗ or new(db) thing∗[100]) are not distinguished as separate types, but are displayed together. 

OPTIONS

-a Prints the total length of the info segment immediately after the length of the data segment. 

-c Prints the type contents for each segment. 

-C Prints the type contents for the entire database. 

-D pathname Prints information about a directory database instead of an invdividual database.  pathname is interpreted as the name of a Server host on which to look for the directory database. 

-f Prints information about the location of all free blocks of storage in a segment. 

-n segment-number Prints information only about the segment specified as segment-number, rather than information about every segment in the data base.  segment-number is a "data segment" number, such as those printed by the -a option.  -n is particularly useful in conjunction with -o and -c, since it reduces the amount of output. 

-o Prints a complete table of every object in the segment, showing its offset and size.  This table contains an enormous amount of data, which  can be useful in  debugging. Do not confuse this with the -0 option, described below. 

-ss Prints the type summaries by the space used by the instances of each type (this is the default). 

-sn Prints the type summaries by the number of instances of each type. 

-st Prints the type summaries alphabetically by type-name.

-u Causes ossize to open the database for read/write rather than read-only. This option is ordinarily used only when you get an error message telling you to do so, during an automatic upgrading of database roots from the Release 1.0 format to the Release 1.1 format that was stopped because of a read-only circumstance. 

-w workspace-name Runs ossize with the current workspace set to workspace-name, which must be the name of a workspace stored in this database. This allows you to examine the size (and contents, with -c and f ) of a particular version of the database. If you don’t provide a -w argument, the "transient workspace" is used as the current workspace (that is, the usual default). If there is a segment that isn’t known by the current workspace, ossize prints "Error: there is no version of this segment in this workspace". 

-W Prints a list of all the named workspaces that are stored in the specified database. 

-0 Causes ossize to include the internal segment 0 in type summaries.  This implies -c if neither -c nor -C is set. 

DESCRIPTION

ossize prints out the comment for each segment that has a (non-zero-length) comment. 

FILES

$OS_ROOTDIR/bin/ossize

ObjectStore 2.0  —  Last change: October 1992

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026