*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> tis_write_trylock (3)              



NAME    [Toc]    [Back]

       tis_write_trylock  -  Attempts  to  acquire  the specified
       read-write lock for write access

SYNOPSIS    [Toc]    [Back]

       #include <tis.h>

       int tis_write_trylock(
               tis_rwlock_t *lock );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc.so, libc.a)

STANDARDS    [Toc]    [Back]


PARAMETERS    [Toc]    [Back]

       Address of the read-write lock to be  acquired  for  write

DESCRIPTION    [Toc]    [Back]

       This  routine  attempts  to  acquire a read-write lock for
       write access. The routine attempts to immediately  acquire
       the  lock.  If the lock is acquired, zero (0) is returned.
       If the lock is held by another thread (for either read  or
       write  access), [EBUSY] is returned and the calling thread
       does not wait for the write-access lock to be acquired.

       Note that it is a coding error to attempt to  acquire  the
       lock  for  write access if the lock is already held by the
       calling thread. (However,  this  routine  returns  [EBUSY]
       anyway,  because no ownership error-checking takes place.)

RETURN VALUES    [Toc]    [Back]

       If an error condition  occurs,  this  routine  returns  an
       integer  value  indicating  the  type  of  error. Possible
       return values are as follows: Successful  completion;  the
       lock  is  acquired  for  write  access.   The lock was not
       acquired for write  access,  as  it  is  already  held  by
       another thread.

ERRORS    [Toc]    [Back]


SEE ALSO    [Toc]    [Back]

       Functions:      tis_read_lock(3),     tis_read_trylock(3),
       tis_read_unlock(3),                 tis_rwlock_destroy(3),
       tis_rwlock_init(3), tis_write_lock(3), tis_write_unlock(3)

       Manuals: Guide to DECthreads and Programmer's Guide

[ Back ]
 Similar pages
Name OS Title
pthread_rwlock_tryrdlock Tru64 Attempts to acquire a readwrite lock for read access without waiting
pthread_rwlock_trywrlock Tru64 Attempts to acquire a readwrite lock for write access without waiting
tis_read_trylock Tru64 Attempts to acquire a read-write lock for read access and does not wait if the lock cannot be immedi...
sulog IRIX log of all su attempts
tis_mutex_trylock Tru64 Attempts to lock the specified mutex
loginlog IRIX log of failed login attempts
unknown IRIX Handle attempts to use non-existent commands
Foreign Tru64 Logs contact attempts from unknown systems
pthread_mutex_trylock Tru64 Attempts to lock the specified mutex, without waiting if already locked
remote.unknown Tru64 Logs access attempts by unknown remote systems
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service