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

  
 
  

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 message'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  mes-
	    sage will be stored. This number is the absolute message position 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  Johan
     Billing <billing@df.lth.se>.

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

				   2002-11-07			 JAM_FindUser(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=JAM_FindUser&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help