.th MCE VIII 4/21/86
.sh NAME
mce - modify KSOS file system control entries
.sh SYNOPSIS
 mce
deviceseid extent [-rvp]
.sh DESCRIPTION
Mce is a file system maintenance tool which can be used to
interactively view and modify KSOS file system control slots.  The
argument deviceseid specifies the device on which the file system
resides (e.g.  d1/0).  Extent is a decimal integer specifying the
extent on which the file system resides.  By default mce is rather
verbose and leads the user by the hand; the -v option instructs mce to
interact with the user in an even more verbose mode.  The -p option
instructs mce to print out the direct and indirect pointer table values
when viewing a jnode.  The -r option indicates read only operation
where slots may be viewed but not modified.  This option allows the
user to view a mounted file system.  Only an unmounted file system may
be modified.
.s1
Commands which operate on a particular slot may be optionally preceded
by the slot number.  If no slot number is supplied the current slot is
assumed.  Mce considers all numbers to be decimal, except where
explicitly stated otherwise.  Recognized commands include:
.s1
.lp 13 8
+	Increment current slot by one.
.s1
.lp 13 8
-	Decrement current slot by one.
.s1
.lp 13 8
[n]v	View slot.
A formatted dump of the contents of the specified slot is produced.
Slots of type jnode, indirect, reserved,
free, mount item, extent item, and allocation item are recognized.
Where [n] equates to the number of the jnode to be viewed.
.s1
.lp 13 8
[n]i[m]	Set current slot to the slot number pointed to by
indirect pointer number m of the jnode or indirect slot
number n.
.s1
.lp 13 8
[n]f	Free the slot specified by the number [n]. Returns slot to free space.
.s1
.lp 13 8
e	Exit
mce.
.s1
.lp 13 8
[n]m	Modify slot specified by number [n].
This command places the user in modification mode.
At this time jnodes, indirects and mount items may be modified.
A special prompt (*) indicates modification mode.
After receiving the prompt, the user types
the control character corresponding to the slot field
to be modified
and
mce
responds by asking for specific data.
To return to normal mode, type an empty line (<CR> only).
Modifications are buffered until leaving modification mode,
at which time the user may elect to save the changes
or throw them away.
Control characters for each type of slot are listed below.
.s1
jnode:
.lp 18 4
v	view jnode.
.lp 18 4
a	modify access rights, security and integrity.
.lp 18 4
c	modify condition field.
.lp 18 4
l	modify link count field.
.lp 18 4
h	modify high block field.
.lp 18 4
p	modify privileges.
.lp 18 4
t	modify tail count field.
.lp 18 4
s	modify self field.
.lp 18 4
i	modify indirect pointer table.
.lp 18 4
d	modify direct pointer table.
.i0
.ti 13
.s1
indirect slot:
.lp 18 4
v	view indirect slot.
.lp 18 4
h	modify home jnode field.
.lp 18 4
p	modify parent field.
.lp 18 4
t	modify treeN field.
.lp 18 4
i	modify indirect pointer table.
.lp 18 4
d	modify direct pointer table.
.i0
.s1
.ti 13
mount item:
.lp 18 4
v	view mount item.
.lp 18 4
a	modify access, security and integrity information.
.lp 18 4
m	modify mounted field.
.i0
.sh PRIVILEGES
privMount		(* temporary *)
.br
.br
privViolStarSecurity
.br
privViolStarIntegrity
.br
privViolDiscrAccess
.br
.sh WARNINGS
Mce
is a powerful tool.
Because of its power, it is also a very dangerous tool.
A malicious user, or even a well-intentioned user who mistypes a character
could potentially invalidate an entire file system
or worse.
.sh NOTES
MCE sends no audit capture messages.
