workbench/libs/camd/startclusternotify.c

   1 /*
   2     Copyright © 1995-2007, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc:
   6     Lang: English
   7 */
   8
   9 #include <proto/exec.h>
  10
  11 #include "camd_intern.h"
  12
  13 /*****************************************************************************
  14
  15     NAME */
  16
  17         AROS_LH1(void, StartClusterNotify,
  18
  19 /*  SYNOPSIS */
  20         AROS_LHA(struct ClusterNotifyNode *,cn,A0),
  21
  22 /*  LOCATION */
  23         struct CamdBase *, CamdBase, 37, Camd)
  24
  25 /*  FUNCTION
  26         void StartClusterNotify(struct ClusterNotifyNode *cn)
  27
  28     INPUTS
  29         pointer to initialized ClusterNotifyNode structure
  30
  31     RESULT
  32         void
  33
  34     NOTES
  35         ClusterNotifyNode structure must remain valid until EndClusterNotify();
  36         Will only signal added and removed clusters, not internal state changes.
  37
  38     EXAMPLE
  39         struct ClusterNotifyNode cnn;
  40
  41         cnn.cnn_Task=IExec->FindTask(NULL);
  42         cnn.cnn_SigBit=IExec->AllocSignal(-1);
  43         StartClusterNotify(&cnn);
  44
  45                     somewhere down the line...
  46
  47         Wait(1L<<cnn.cnn_SigBit)
  48             printf("Cluster Changes have happened\n");
  49
  50     BUGS
  51
  52     SEE ALSO
  53         EndClusterNotify()
  54
  55     INTERNALS
  56
  57     HISTORY
  58
  59         2001-01-12 ksvalast first created
  60     2005-05-07 Lyle Hazelwood first implemented.
  61
  62 *****************************************************************************/
  63 {
  64     AROS_LIBFUNC_INIT
  65
  66     if(cn == NULL)    return;
  67     AddTail(&CB(CamdBase)->clusnotifynodes,(struct Node *)&cn->cnn_Node);
  68         return;
  69
  70    AROS_LIBFUNC_EXIT
  71 }
  72