Description

The process tool conveys the authority to fabricate processes from nodes, and to verify the provenance of start keys from various other objects. The process tool is a closely restricted key.

Check Alleged Key Type (OC = KT)

Returns the alleged type of the key.

Reply

R1

0x100000A: Key is a process tool.

Make Process Key (OC = 0)

Takes a node key and fabricates a process key (see the process page) with that node as the process root.

Request	SK0	A node key
Reply	RK0	A process key if the operation is successful, a void key otherwise.
Result	RC_OK	Operation completed successfully.
	RC_RequestError	Passed key is not a node key.

Identify Gate Key (OC = 1)

Takes a gate key (start, resume, or fault key) and brand key. Checks if the passed brand key matches the brand key in slot DR4 of the process named by the gate key (see the process page). If so, returns a node key to the process root and provides an indication of the key type in the result code. Otherwise returns a void key.

Request	SK0	A start key
	SK1	A brand key.
Reply	RK0	A node key to the process root of the process named by the start key if the operation is successful. A void key otherwise.
	R1	0: brand did not match. 1: gate key was a start key. 2: gate key was a resume key.
	R2	Key Info field if gate key, else zero. If the gate key is a resume key, the key info field may be either zero or one: 0: Normal resume capability. 1: fault capability.
Result	RC_OK	Operation completed successfully.
	RC_RequestError	Inappropriate keys passed.

Identify Process Key (OC = 2)

Takes a process key and brand key. Checks if the passed brand key matches the brand key in slot DR4 (see the process page) of the process named by the process key. If so, returns a node key to the process root. Otherwise returns a void key.

Request	SK0	A process key
	SK1	A brand key.
Reply	RK0	A node key to the process root of the process named by the start key. If the brand did not match, Returned key is a void key.
	R1	0: brand did not match. Returned key is void key. 1: brand matched. Returned key is a node key.
Result	RC_OK	Operation completed successfully.
	RC_RequestError	Passed key is not a node key.

Identify Segment With Gate Key for Keeper (OC = 3)

Takes a segment (or node) key and brand key. Checks if the passed brand key matches the brand key in slot DR4 (see the process page) of the segment's keeper. If so, returns a node key to the segment named by the segment key. Otherwise returns a void key. The no-call bit of the segment must be off.

Request	SK0	A segment key to a segment whose keeper slot contains a gate key to the process identified by the brand.
	SK1	A brand key.
Reply	RK0	A node key to the node named by the segment key.
	R1	0: brand did not match. 1: gate key was a start key. 2: gate key was a resume key.
	R2	Key Info field if gate key, else zero. If the gate key is a resume key, the key info field may be either zero or one: 0: Normal resume capability. 1: fault capability.
Result	RC_OK	Operation completed successfully.
	RC_RequestError	Passed key is not a node key.

Compare Process Origins (OC = 4)

Takes two keys to process (start, resume, or process). Checks if the brand slots of the two processes contain the same brand. Returns result (equal/not equal) in R0. Note that the processes named by the passed keys need not be well-formed for the test to succeed.

Request	SK0	A process or gate key
	SK1	A process or gate key
Reply	R1	0: brands did not match 1: brands matched
Result	RC_OK	Operation completed successfully.
	RC_RequestError	Passed keys were not process keys.