rom/dos/info.c

   1 /*
   2     Copyright © 1995-2007, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc:
   6     Lang: English
   7 */
   8 #include <proto/exec.h>
   9
  10 #include "dos_intern.h"
  11
  12 /*****************************************************************************
  13
  14     NAME */
  15
  16 #include <proto/dos.h>
  17
  18         AROS_LH2(LONG, Info,
  19
  20 /*  SYNOPSIS */
  21         AROS_LHA(BPTR             , lock, D1),
  22         AROS_LHA(struct InfoData *, parameterBlock, D2),
  23
  24 /*  LOCATION */
  25         struct DosLibrary *, DOSBase, 19, Dos)
  26
  27 /*  FUNCTION
  28
  29     Get information about a volume in the system.
  30
  31     INPUTS
  32
  33     lock            --  a lock on any file on the volume for which information
  34                         should be supplied, or 0
  35     parameterBlock  --  pointer to an InfoData structure
  36
  37     RESULT
  38
  39     Boolean indicating success or failure. If TRUE (success) the
  40     'parameterBlock' is filled with information on the volume.
  41
  42     NOTES
  43     Supplying a lock of 0 will return InfoData from the task
  44     that is returned from GetFileSysTask().
  45     (Usually the boot volumes' filesystem "SYS:")
  46
  47     EXAMPLE
  48
  49     BUGS
  50
  51     SEE ALSO
  52
  53     <dos/dos.h>
  54
  55     INTERNALS
  56
  57 *****************************************************************************/
  58 {
  59     AROS_LIBFUNC_INIT
  60
  61     struct FileLock *fl = (struct FileLock *)BADDR(lock);
  62     LONG status;
  63
  64     status = dopacket2(DOSBase, NULL, fl ? fl->fl_Task : GetFileSysTask(), ACTION_INFO, lock, MKBADDR(parameterBlock));
  65     return status;
  66
  67     AROS_LIBFUNC_EXIT
  68 } /* Info */