/* Unlock
* remove lock
*
* if object is already unlocked, the operation is idempotent
* and returns an rc state of rcUnlocked
*
* "type" [ IN ] - a KDBPathType
* valid values are kptDatabase, kptTable and kptIndex
*
* "path" [ IN ] - NUL terminated path
*/
LIB_EXPORT rc_t CC KDatabaseVUnlock ( KDatabase *self, uint32_t type, const char *name, va_list args )
{
rc_t rc = 0;
char path [ 256 ];
rc = KDatabaseLockInt (self, path, sizeof path, type, name, args);
if (rc == 0)
rc = KDBUnlockDir (self->dir, path);
return rc;
}
/* Unlock
* remove lock
*
* if object is already unlocked, the operation is idempotent
* and returns an rc state of rcUnlocked
*
* "path" [ IN ] - NUL terminated path
*/
LIB_EXPORT rc_t CC KDBManagerVUnlock ( KDBManager *self, const char *path, va_list args )
{
rc_t rc;
char full [ 4096 ];
if ( self == NULL )
rc = RC ( rcDB, rcMgr, rcUnlocking, rcSelf, rcNull );
else
{
/* get full path to object */
rc = KDirectoryVResolvePath ( self -> wd, true,
full, sizeof full, path, args );
if ( rc == 0 )
{
/* TBD:
Add code to validate that this path is not in a container
object's control. That is the last facet in the path
is the name of the object. To be valid the facet before
must not be "col", "tbl", or "db" as in those cases
the KDBManager should not be called for this object but
its containing object
*/
/* if the path is not writable because it is already locked
* we attempt to unlock it.
*
* if the return is 0 from Writable than it was already
* unlocked so we say so and thus again the
* the return from this will contain "rcLocked" and the
* caller will be forced to check for zero or RCState(rcUnlocked)
*
* a side effect is that if the call does not return 0 it will
* be a wrong type to lock with the DBManager
*/
rc = KDBManagerWritableInt ( self -> wd, path );
if ( rc == 0 )
rc = RC ( rcDB, rcMgr, rcUnlocking, rcLock, rcUnlocked );
else if ( GetRCState ( rc ) == rcLocked )
{
rc = KDBManagerCheckOpen ( self, path );
if ( rc == 0 )
rc = KDBUnlockDir ( self -> wd, path );
}
}
if ( rc != 0 )
rc = ResetRCContext ( rc, rcDB, rcMgr, rcUnlocking );
}
return rc;
}
