Previous section.

Protocols for Interworking: XNFS, Version 3W
Copyright © 1998 The Open Group

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.


Why not acquire a nicely bound hard copy?
Click here to return to the publication details or order a copy of this publication.

Contents Next section Index