rom/exec/deletemsgport.c

   1 /*
   2     Copyright © 1995-2001, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc: Free a message port.
   6     Lang: english
   7 */
   8 #include <exec/ports.h>
   9 #include <exec/execbase.h>
  10 #include <aros/libcall.h>
  11 #include <proto/exec.h>
  12
  13 /*****************************************************************************
  14
  15     NAME */
  16
  17         AROS_LH1(void, DeleteMsgPort,
  18
  19 /*  SYNOPSIS */
  20         AROS_LHA(struct MsgPort *, port, A0),
  21
  22 /*  LOCATION */
  23         struct ExecBase *, SysBase, 112, Exec)
  24
  25 /*  FUNCTION
  26         Delete a messageport allocated with CreateMsgPort(). The signal bit
  27         is freed and the memory is given back to the memory pool. Remaining
  28         messages are not replied. It is safe to call this function with a
  29         NULL pointer.
  30
  31     INPUTS
  32         port - Pointer to messageport structure.
  33
  34     RESULT
  35
  36     NOTES
  37
  38     EXAMPLE
  39
  40     BUGS
  41
  42     SEE ALSO
  43
  44     INTERNALS
  45
  46 ******************************************************************************/
  47 {
  48     AROS_LIBFUNC_INIT
  49
  50     /* Only if there is something to free */
  51     if(port!=NULL)
  52     {
  53         /* Free signal bit */
  54         FreeSignal(port->mp_SigBit);
  55
  56         /* And memory */
  57         FreeMem(port,sizeof(struct MsgPort));
  58     }
  59     AROS_LIBFUNC_EXIT
  60 } /* DeleteMsgPort */