Previous section.

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


NLM_TEST - Test Lock

Call Arguments

struct nlm_testargs { netobj cookie; bool exclusive; struct nlm_lock alock; };

Return Arguments

struct nlm_testres { netobj cookie; nlm_testrply test_stat; };

RPC Procedure Description

nlm_testres NLM_TEST(nlm_testargs) = 1;


This procedure tests to see whether the monitored lock specified by "alock" is available to this client.

Return Codes

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

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

Indicates that the test 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.


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


Indicates that the procedure call 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