workbench/libs/nonvolatile/getnvlist.c

   1 /*
   2     Copyright © 1995-2006, The AROS Development Team. All rights reserved.
   3     $Id$
   4 */
   5
   6 #include <dos/dosextens.h>
   7
   8 /*****************************************************************************
   9
  10     NAME */
  11
  12 #include <exec/lists.h>
  13 #include <libraries/nonvolatile.h>
  14 #include <proto/exec.h>
  15 #include <proto/nvdisk.h>
  16
  17 #include <string.h>
  18
  19
  20 AROS_LH2(struct MinList *, GetNVList,
  21
  22 /*  SYNOPSIS */
  23
  24         AROS_LHA(STRPTR, appName,        A0),
  25         AROS_LHA(BOOL,   killRequesters, D1),
  26
  27 /*  LOCATION */
  28
  29         struct Library *, nvBase, 10, Nonvolatile)
  30
  31 /*  FUNCTION
  32
  33     Returns a list of items allocated by application 'appName'.
  34
  35     INPUTS
  36
  37     appName         --  the application the nonvolatile items of which to query
  38                         about
  39     killRequesters  --  if TRUE you make sure that no system requesters will be
  40                         displayed during the operation of this function
  41
  42     RESULT
  43
  44     Pointer to a MinList of NVEntries which describes the items. Failure due to
  45     lack of memory will be indicated by returning NULL.
  46
  47     NOTES
  48
  49     The protection field should be examined using the field masks NVIF_DELETE
  50     or by the bit definition NVIB_DELETE as the other bits are reserved for
  51     system use.
  52
  53     EXAMPLE
  54
  55     BUGS
  56
  57     SEE ALSO
  58
  59     FreeNVData(), SetNVProtection(), <libraries/nonvolatile.h>
  60
  61     INTERNALS
  62
  63 ******************************************************************************/
  64
  65 {
  66     AROS_LIBFUNC_INIT
  67
  68     struct Process *me = (struct Process *)FindTask(NULL);
  69     APTR oldReq = me->pr_WindowPtr;
  70     struct MinList *list;
  71
  72     if(appName == NULL)
  73         return NULL;
  74
  75     if(strpbrk(appName, ":/") != NULL)
  76         return NULL;
  77
  78     if(killRequesters)
  79         me->pr_WindowPtr = (APTR)-1;
  80
  81     list = GetNVDItemList(appName);
  82
  83     if(killRequesters)
  84         me->pr_WindowPtr = oldReq;
  85
  86     return list;
  87
  88     AROS_LIBFUNC_EXIT
  89 } /* GetNVList */