home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / tools / developer-tools / aros / source / exec / messages / src / findport.c < prev    next >
Encoding:
C/C++ Source or Header  |  1996-07-16  |  1.1 KB  |  57 lines
  1. /*
  2.     $Id$
  3.     $Log$
  4.     Desc:
  5.     Lang: english
  6. */
  7. #include "exec_intern.h"
  8.  
  9. /*****************************************************************************
  10.  
  11.     NAME */
  12.     #include <clib/exec_protos.h>
  13.  
  14.     __AROS_LH1(struct MsgPort *, FindPort,
  15.  
  16. /*  SYNOPSIS */
  17.     __AROS_LA(UBYTE *, name, A1),
  18.  
  19. /*  LOCATION */
  20.     struct ExecBase *, SysBase, 65, Exec)
  21.  
  22. /*  FUNCTION
  23.     Look for a public messageport by name. This function doesn't
  24.     arbitrate for the port list and must be protected with a Forbid()
  25.     Permit() pair.
  26.  
  27.     INPUTS
  28.     port - Pointer to NUL terminated C string.
  29.  
  30.     RESULT
  31.     Pointer to struct MsgPort or NULL if there is no port of that name.
  32.  
  33.     NOTES
  34.  
  35.     EXAMPLE
  36.  
  37.     BUGS
  38.  
  39.     SEE ALSO
  40.  
  41.     INTERNALS
  42.  
  43.     HISTORY
  44.     29-10-95    digulla automatically created from
  45.                 exec_lib.fd and clib/exec_protos.h
  46.     17-12-95    digulla Incorporated code by Matthias Fleischner
  47.  
  48. *****************************************************************************/
  49. {
  50.     __AROS_FUNC_INIT
  51.  
  52.     /* Nothing spectacular - just look for that name. */
  53.     return (struct MsgPort *)FindName(&SysBase->PortList,name);
  54.  
  55.     __AROS_FUNC_EXIT
  56. } /* FindPort */
  57.