Name

NLM_LOCK_RES - Establish a Lock Result

Call Arguments

 

struct nlm_res {
    netobj cookie;
    nlm_stat stat;
};

Return Arguments

None.

RPC Procedure Description

 

void
NLM_LOCK_RES(nlm_res) = 11;

Description

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

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

LCK_GRANTED

Indicates that the procedure completed successfully; the lock was granted.

LCK_DENIED

Indicates that the procedure failed because the request conflicted with existing lock reservations for the file.

LCK_DENIED_NOLOCKS

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

LCK_BLOCKED

Indicates that the blocking request cannot be granted immediately. The NLM on the server will make a call-back to the client with an NLM_GRANTED procedure when the lock can be granted.

LCK_DENIED_GRACE_PERIOD

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