$cpt = new Safe [(namespace, mask)]

Constructor. Creates a new compartment. Takes the following arguments:

namespace

Optional. Root namespace to use for the compartment. Default is Safe::Root0, which autoincrements for each new compartment.

mask

Optional. Operator mask to use; defaults to a restrictive set.

$cpt->mask ([mask])

Sets operator mask for the compartment if mask is specified; otherwise, it gets the current mask.

$cpt->rdo (filename)

Evaluates the contents of file filenameinside the compartment.

$cpt->reval (string)

Evaluates string as Perl code inside the compartment.

$cpt->root ([namespace])

If namespace is specified, sets the root namespace for the compartment; otherwise, gets the current namespace.

$cpt->share (varname[, ...])

Shares the variable(s) in the argument list with the compartment.

$cpt->trap (op[, ...])

For each operator specified in the argument list, sets the corresponding bit in the compartment's operator mask.

$cpt->untrap (op[, ...])

For each operator specified in the argument list, resets the corresponding bit in the compartment's operator mask.

$cpt->varglob (varname)

Returns a glob for the symbol table entry of varname in the compartment's package.

emptymask

Returns a mask with all operators unmasked.

fullmask

Returns a mask with all operators masked.

mask_to_ops (mask)

Takes an operator mask mask and returns a list of the names of operators masked in mask.

MAXO

Returns the number of operators in a mask (and hence its length).

opcode (op[, ...])

Takes a list of operator names and returns the corresponding list of opcodes.

op_mask

Returns the operator mask in effect at the time the invocation to the subroutine was compiled.

opname (op[, ...])

Takes a list of opcodes and returns the corresponding list of operator names.

ops_to_mask (op[, ...])

Takes a list of operator names and returns an operator mask with those operators masked.