Name

NLM_UNLOCK - Unlock File

Call Arguments

 

struct nlm_unlockargs {
    netobj cookie;        
    struct nlm_lock alock;
};

Return Arguments

 

struct nlm_res {
    netobj cookie;
    nlm_stat stat;
};

RPC Procedure Description

 

nlm_res
NLM_UNLOCK(nlm_unlockargs) = 4;

Description

This routine will remove the lock specified by "alock". The valuse of the following fields in the "alock" structure must match the corresponding "alock" fields in the call that created the lock (NLM_LOCK, NLM_NM_LOCK or NLM_LOCK_MSG): caller_name, fh, oh, and uppid.

Return Codes

When the procedure returns, "stat" will be set to one of the following values:

LCK_GRANTED

Indicates that the procedure completed successfully. The NLM may also return this code even if the "alock.oh" of the NLM_UNLOCK procedure call does not match the holder of the lock, or if there is no matching lock.

LCK_DENIED_GRACE_PERIOD

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