1 /** 

     2  *  @file MsgQClean.cpp

     3  *  Description: Source file for MsgQLib's MsgQClean API

     4  *  Copyright (c) 2007 Nokia Corporation.

     5 *  All rights reserved.

     6 *  Redistribution and use in source and binary forms, with or without modification, 

     7 *  are permitted provided that the following conditions are met:

     8 *  Redistributions of source code must retain the above copyright notice, this list 

     9 *  of conditions and the following disclaimer.Redistributions in binary form must 

    10 *  reproduce the above copyright notice, this list of conditions and the following 

    11 *  disclaimer in the documentation and/or other materials provided with the distribution.

    12 *  Neither the name of the Nokia Corporation nor the names of its contributors may be used 

    13 *  to endorse or promote products derived from this software without specific prior written 

    14 *  permission.

    15 *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY 

    16 *  EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 

    17 *  OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT 

    18 *  SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 

    19 *  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT 

    20 *  OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 

    21 *  HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 

    22 *  (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, 

    23 *  EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

    24  */

    25 

    26 #include <errno.h>

    27 #include <sys/msg.h>

    28 #include <msgqinternal.h>

    29 

    30 

    31 /****************************************************************************

    32 * MsgQClean (qName, err)

    33 * Description: Function that empties the specified queue

    34 *****************************************************************************/

    35 

    36 EXPORT_C int MsgQClean(ULONG qName, int* err) {

    37 

    38 	char msg[MAX_MSG_LEN];

    39 	int rcv_err;

    40 

    41 	if(( msgget((key_t) qName ,IPC_CREAT | 0666 /*| IPC_EXCL */ )) >=0 ) {

    42 		// sending a message is not allowed

    43 		// empty out the queue 

    44 		while(MsgQReceive(qName, msg, MAX_MSG_LEN, IPC_NOWAIT, &rcv_err) != ERROR) {};

    45 		if (rcv_err == ENOMSG) {

    46 			*err = OK;

    47 			return (OK);

    48 		}

    49 		else

    50 			*err = rcv_err;

    51 	}

    52 	else

    53 		*err = KMsgQLibQIdErr;

    54 

    55 	return(ERROR);

    56 }

    57 

    58