PARAMETERS

[in ledger send right]
The wired kernel memory ledger providing the
space from which the ledger itself is drawn.

child_ledger

[out ledger send right]
The new child ledger, of the same resource type
as the parent ledger.

transfer

[in scalar]
The resource amount to transfer to the new ledger.

DESCRIPTION

The ledger_create function creates a subordinate ledger.
Resource limits can be
transferred from the parent ledger. The child ledger itself
is accounted against
the ledger_ledger. A new ledger inherits the remote service port.

NOTES

This interface is not implemented in OSF/1 R1.3.

A ledger limit of LEDGER_ITEM_INFINITE allows any amount (even
infinity) to be withdrawn. The root ledger has such a limit.

RETURN VALUES

KERN_RESOURCE_SHORTAGE

Transferring the resources would cause the parent ledger to exceed its
limits.