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

FreeBSD Manual Pages

  
 
  

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

NAME
       JAM_FindUser - Find message to a	user

SYNOPSIS
       #include	<jamlib/jam.h>

       int JAM_FindUser(s_JamBase* Base_PS,
			ulong	   UserCrc_I,
			ulong	   StartMsg_I,
			ulong*	   MsgNo_PI);

DESCRIPTION
       Scans  the  message  base  looking  for a message written to a specific
       user.

   Arguments
       Base_PS
	      The message base to use

       UserCrc_I
	      The CRC32	value for the searched name

       StartMsg_I
	      The first	message	number to look at. This	value is not the  mes-
	      sage's  unique  number,  but rather the absolute position	of the
	      message in the message base. Message 0 therefore means the first
	      message.

       MsgNo_PI
	      A	 pointer  to a variable	where the message number for the found
	      message will be stored. This number is the absolute message  po-
	      sition in	the message base. Message 0 means the first message.

RETURN VALUE
       0      if successful

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

       JAM_NO_USER
	      if no message was	found

EXAMPLES
       uchar Name_AC[32];
       int   Result_I;
       ulong Crc_I;
       ulong Msg_I;

       strcpy(Name_AC, "Bjorn Stenberg");

       Crc_I = JAM_Crc32(Name_AC, strlen(Name_AC));

       Result_I	= JAM_FindUser(Base_PS,	Crc_I, 0, &Msg_I);

       switch (Result_I) {
	 case JAM_NO_USER:
	   printf("No message for me.\n");
	   break;

	 case JAM_IO_ERROR:
	   printf("IO error %d\n", JAM_Errno());
	   break;
       }

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_Crc32(3),	JAM_Errno(3)

				  2002-11-07		       JAM_FindUser(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_FindUser&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help