compiler/alib/createport.c

   1 /*
   2     Copyright © 1995-2007, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc: amiga.lib function CreatePort()
   6     Lang: english
   7 */
   8
   9 #include <proto/exec.h>
  10
  11 /*****************************************************************************
  12
  13     NAME */
  14 #include <exec/ports.h>
  15 #include <proto/alib.h>
  16
  17         struct MsgPort * CreatePort (
  18
  19 /*  SYNOPSIS */
  20         STRPTR name,
  21         LONG   pri)
  22
  23 /*  FUNCTION
  24         Allocate and initialize a new Exec message port. You must
  25         use DeletePort() to get rid of it.
  26
  27     INPUTS
  28         name - The name of the new port. The string is not copied
  29         pri - The priority of the port.
  30
  31     RESULT
  32         A pointer to the new message port or NULL if no memory or
  33         no signal was available.
  34
  35     NOTES
  36
  37     EXAMPLE
  38
  39     BUGS
  40
  41     SEE ALSO
  42         DeletePort(), exec.library/CreateMsgPort(), exec.library/DeleteMsgPort()
  43
  44     INTERNALS
  45
  46     HISTORY
  47
  48 ******************************************************************************/
  49 {
  50     struct MsgPort * mp;
  51
  52     mp = CreateMsgPort ();
  53
  54     if (mp)
  55     {
  56         mp->mp_Node.ln_Name = name;
  57         mp->mp_Node.ln_Pri  = pri;
  58
  59         if (name)
  60             AddPort (mp);
  61     }
  62
  63     return mp;
  64 } /* CreatePort */
  65