Name

NLM_TEST_RES - Test Lock Result

Call Arguments

 

struct    nlm_testres {
    netobj       cookie;
    nlm_testrply test_stat;
};

Return Arguments

None.

RPC Procedure Description

 

void
NLM_TEST_RES(nlm_testres) = 11;

Description

This procedure is one of the asynchronous RPCs. The server calls this procedure to return results of the NLM_TEST_MSG procedure to the client (the host issuing the NLM_TEST_MSG call).

"test_stat.stat" will be set to one of the following values:

LCK_GRANTED

Indicates that the "NLM_TEST_MSG" procedure completed successfully. The server would be able to grant the lock in question.

LCK_DENIED

Indicates that the "NLM_TEST_MSG" failed as it conflicted with existing lock reservations for the file. "test_stat.holder" describes the current holder of the lock as follows. The boolean "exclusive" indicates whether the lock is exclusively held by the current holder, or whether other locks are permitted. The integer "uppid" provides a unique per-process identifier for lock differentiation. The unsigned values "l_offset" and "l_len" define the region of the file locked by this holder.

LCK_DENIED_NOLOCKS

Indicates that the "NLM_TEST_MSG" failed because the server NLM could not allocate the resources needed to process the request.

LCK_DENIED_GRACE_PERIOD

Indicates that the "NLM_TEST_MSG" failed because the server host has recently been rebooted and its NLM is re-establishing existing locks, and is not yet ready to accept normal service requests.