Dbtlockf()

PURPOSE

test for a lock on a database file

SYNOPSIS

#include "dbl.h"
 
	int	dbtlock(dbf)
 
	<input parameter>
	char	*dbf;		/* File descriptor of a .DBF file to be locked	*/
 
	<output parameter>
	none

RETURN VALUE

The dbtlockf() function returns 0 for success, or < 0 if an error occurs. See the section on return values for a detailed list of return codes.

DESCRIPTION

The dbtlockf() function tests to see if a database file is already locked by another user.

EXAMPLE

The following example test locks the .DBF file whose file descriptor is in "char *dbf".

#include "dbl.h"
 
	char	*dbf;		/* Database file descriptor	*/
	int	rc;		/* Return code			*/
 
	rc = dbtlockf(dbf);
	if (rc = SUCCESS) printf("file is locked n");
	else {
		printf("file could not be locked n");
		return (ERROR);
	}

SEE ALSO

dbfilemode(), dblockf(), dblocki(), dblockr(), dbunlockf(), dbunlocki(), dbunlockr()