Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
JAM_LockMB(3)		    JAM	subroutine library		 JAM_LockMB(3)

NAME
       JAM_LockMB - Lock message base for exclusive access

SYNOPSIS
       #include	<jamlib/jam.h>

       int JAM_LockMB(s_JamBase* Base_PS);

DESCRIPTION
       Locks  the  currently  open  message base so that no other programs may
       modify it. The message base should be locked for	only small periods  of
       time, or	the performance	of tossers and other software may be affected.

   Arguments
       Base_PS
	      The message base to lock

RETURN VALUE
       0      if successful

       JAM_IO_ERROR
	      if an I/O	error occured. see JAM_Errno(3)

       JAM_LOCK_FAILED
	      if the message base is currently locked by another process

       JAM_BAD_PARAM
	      if Base_PS is NULL

EXAMPLES
       int	  Result_I;

       while (1) {
	   Result_I = JAM_LockMB(Base_PS);
	   if (Result_I) {

	      if (Result_I == JAM_LOCK_FAILED)
		  /* base locked by someone else, wait for unlock */
		  sleep(1);

	      else {
		  /* error */
		  printf("JAM_LockMB returned %d.\n", Result_I);
		  return -1;
	      }
	   }
       }

AUTHOR
       This manual page	was created by Sir Raorn <raorn@altlinux.ru>, based on
       original	JAMlib documentation by	Bjorn Stenberg <bjorn@haxx.nu> and Jo-
       han Billing <billing@df.lth.se>.

SEE ALSO
       jamlib(3), JAM_UnlockMB(3), JAM_Errno(3)

				  2002-11-07			 JAM_LockMB(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | EXAMPLES | AUTHOR | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=JAM_LockMB&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help