rom/dos/info.c

   1 /*
   2     Copyright © 1995-2013, 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         Get information about a volume in the system.
  29
  30     INPUTS
  31         lock           - a lock on any file on the volume for which information
  32                          should be supplied, or 0
  33         parameterBlock - pointer to an InfoData structure
  34
  35     RESULT
  36         Boolean indicating success or failure. If TRUE (success) the
  37         'parameterBlock' is filled with information on the volume.
  38
  39     NOTES
  40         Supplying a lock of 0 will return InfoData from the task that is
  41         returned from GetFileSysTask() (usually the boot volume's filesystem
  42         "SYS:").
  43
  44     EXAMPLE
  45
  46     BUGS
  47
  48     SEE ALSO
  49         <dos/dos.h>
  50
  51     INTERNALS
  52
  53 *****************************************************************************/
  54 {
  55     AROS_LIBFUNC_INIT
  56
  57     struct FileLock *fl = (struct FileLock *)BADDR(lock);
  58     LONG status;
  59
  60     status = dopacket2(DOSBase, NULL, fl ? fl->fl_Task : GetFileSysTask(), ACTION_INFO, lock, MKBADDR(parameterBlock));
  61     return status;
  62
  63     AROS_LIBFUNC_EXIT
  64 } /* Info */