| java.lang.Object
 org.apache.tomcat.jni.Lock
| Lock | | public class Lock (Code) | | Lock
author:
Mladen Turk
version:
$Revision: 467222 $, $Date: 2006-10-24 05:17:11 +0200 (mar., 24 oct. 2006) $ |
| Method Summary | |
| native public static long | childInit(String fname, long pool)
Re-open a mutex in a child process.
This function must be called to maintain portability, even
if the underlying lock mechanism does not require it.
Parameters:
fname - A file name to use if the mutex mechanism requires one. | | native public static long | create(String fname, int mech, long pool)
Create and initialize a mutex that can be used to synchronize processes.
Warning : Check APR_HAS_foo_SERIALIZE defines to see if the platform supports
APR_LOCK_foo. | | native public static String | defname()
| | native public static int | destroy(long mutex)
Destroy the mutex and free the memory associated with the lock. | | native public static int | lock(long mutex)
Acquire the lock for the given mutex. | | native public static String | lockfile(long mutex)
| | native public static String | name(long mutex)
Display the name of the mutex, as it relates to the actual method used. | | native public static int | trylock(long mutex)
Attempt to acquire the lock for the given mutex. | | native public static int | unlock(long mutex)
Release the lock for the given mutex. |
| APR_LOCK_DEFAULT | | final public static int APR_LOCK_DEFAULT(Code) | | POSIX semaphore process-based locking
|
| APR_LOCK_FCNTL | | final public static int APR_LOCK_FCNTL(Code) | | Enumerated potential types for APR process locking methods
Warning : Check APR_HAS_foo_SERIALIZE defines to see if the platform supports
APR_LOCK_foo. Only APR_LOCK_DEFAULT is portable.
|
| APR_LOCK_FLOCK | | final public static int APR_LOCK_FLOCK(Code) | | fcntl()
|
| APR_LOCK_POSIXSEM | | final public static int APR_LOCK_POSIXSEM(Code) | | POSIX pthread process-based locking
|
| APR_LOCK_PROC_PTHREAD | | final public static int APR_LOCK_PROC_PTHREAD(Code) | | System V Semaphores
|
| APR_LOCK_SYSVSEM | | final public static int APR_LOCK_SYSVSEM(Code) | | flock()
|
| childInit | | native public static long childInit(String fname, long pool) throws Error(Code) | | Re-open a mutex in a child process.
This function must be called to maintain portability, even
if the underlying lock mechanism does not require it.
Parameters:
fname - A file name to use if the mutex mechanism requires one. Thisargument should always be provided. The mutex code itself willdetermine if it should be used. This filename should be thesame one that was passed to apr_proc_mutex_create().
Parameters:
pool - The pool to operate on. Newly opened mutex. |
| create | | native public static long create(String fname, int mech, long pool) throws Error(Code) | | Create and initialize a mutex that can be used to synchronize processes.
Warning : Check APR_HAS_foo_SERIALIZE defines to see if the platform supports
APR_LOCK_foo. Only APR_LOCK_DEFAULT is portable.
Parameters:
fname - A file name to use if the lock mechanism requires one. Thisargument should always be provided. The lock code itself willdetermine if it should be used.
Parameters:
mech - The mechanism to use for the interprocess lock, if any; one ofAPR_LOCK_FCNTLAPR_LOCK_FLOCKAPR_LOCK_SYSVSEMAPR_LOCK_POSIXSEMAPR_LOCK_PROC_PTHREADAPR_LOCK_DEFAULT pick the default mechanism for the platform
Parameters:
pool - the pool from which to allocate the mutex. Newly created mutex. |
| defname | | native public static String defname()(Code) | | Display the name of the default mutex: APR_LOCK_DEFAULT
|
| destroy | | native public static int destroy(long mutex)(Code) | | Destroy the mutex and free the memory associated with the lock.
Parameters:
mutex - the mutex to destroy. |
| lock | | native public static int lock(long mutex)(Code) | | Acquire the lock for the given mutex. If the mutex is already locked,
the current thread will be put to sleep until the lock becomes available.
Parameters:
mutex - the mutex on which to acquire the lock. |
| lockfile | | native public static String lockfile(long mutex)(Code) | | Return the name of the lockfile for the mutex, or NULL
if the mutex doesn't use a lock file
|
| name | | native public static String name(long mutex)(Code) | | Display the name of the mutex, as it relates to the actual method used.
This matches the valid options for Apache's AcceptMutex directive
Parameters:
mutex - the name of the mutex |
| trylock | | native public static int trylock(long mutex)(Code) | | Attempt to acquire the lock for the given mutex. If the mutex has already
been acquired, the call returns immediately with APR_EBUSY. Note: it
is important that the APR_STATUS_IS_EBUSY(s) macro be used to determine
if the return value was APR_EBUSY, for portability reasons.
Parameters:
mutex - the mutex on which to attempt the lock acquiring. |
| unlock | | native public static int unlock(long mutex)(Code) | | Release the lock for the given mutex.
Parameters:
mutex - the mutex from which to release the lock. |
|
|