.th EXI VIII 4/21/86
.sh NAME
exi - initialize pack extents
.sh SYNOPSIS
 exi
deviceSEID [-rv]
.sh DESCRIPTION
Exi is a pack initialization tool which enables the administrative user
to interactively view, define and modify KSOS pack extent map slots.
It is a very powerful tool and should be used carefully.  Exi is
spawned by the secure server at the request of a user running at
OPERATOR or higher integrity level.  It is commonly used to initialize
KSOS file systems.  The argument deviceSeid specifies the pack which is
to be operated on (e.g.  d1/0).  The -r option indicates a read only
mode of operation in which extent map slots may be viewed but not
modified.  The -v option causes exi to interact with the user in a
verbose manner.
.s1
Commands which operate on a particular extent map slot may be optionally
preceded by the extent number.
Specifying extent number 0 allows modification of
the pack master mount item.
If no extent number is supplied the current extent is assumed.
Recognized commands include:
.s1
.lp 13 8
[n]v	View the specified extent map slot.
A formatted dump is produced.
.s1
.lp 13 8
[n]f	Free the extent.
.s1
.lp 13 8
l	List extents.
The extent label, first block number, last block number and extent size
for each extent on the pack are displayed.
.s1
.lp 13 8
[n]a	Add extent.
The user is prompted for all the information necessary to create a new extent.
If desired,
exi
will prompt the user for information needed to initialize the extent
as a KSOS file system.
.s1
.lp 13 8
e	Exit
exi.
.s1
.lp 13 8
[n]m	Modify extent map slot.
This command places the user in modification mode.
Both the pack master mount item and extent items may be modified.
After receiving the prompt, the user types
the control character corresponding to the slot field
to be modified
and
exi
responds by asking for specific data.
To return to normal mode, type an empty line (<CR> only).
Control characters for each type of slot are listed below.
.s1
extent item:
.lp 18 4
v	view extent item.
.lp 18 4
a	modify access rights, security and integrity.
.lp 18 4
l	modify label field.
.lp 18 4
s	modify subtype field.
.i0
.ti 13
.s1
mount item:
.lp 18 4
v	view mount item slot.
.lp 18 4
a	modify access, security and integrity information.
.lp 18 4
l	modify label field.
.i0
.sh SEE ALSO
PKI (VIII), MCE (VIII)
.sh NOTES
Currently exi opens the whole pack unexclusively.  It opens the whole
pack because exi contains the functionality to initialize file systems.
It does not open the pack for exclusive use because, at least
initially, exi must be able to modify extents residing on a pack with a
mounted file system.  Exi should be split into two programs - one for
extent modification which exclusively accesses the extent map extent,
and a separate program for file system initialization.
