rom/dos/deviceproc.c

   1 /*
   2     Copyright © 1995-2007, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc: DeviceProc - Return a handle to a devices process.
   6     Lang: english
   7 */
   8 #include "dos_intern.h"
   9
  10 /*****************************************************************************
  11
  12     NAME */
  13 #include <proto/dos.h>
  14
  15         AROS_LH1(struct MsgPort *, DeviceProc,
  16
  17 /*  SYNOPSIS */
  18         AROS_LHA(CONST_STRPTR, name, D1),
  19
  20 /*  LOCATION */
  21         struct DosLibrary *, DOSBase, 29, Dos)
  22
  23 /*  FUNCTION
  24         DeviceProc() is an obsolete function that returns the Process
  25         responsible for a DOS device. It has been updated to return a
  26         new filesystem device.
  27
  28         DeviceProc() will fail if you ask for the Process of a device
  29         created with AssignPath() as there is no process to return.
  30         If the device requested is an assign, the IoErr() will contain
  31         the Lock to the directory (the function will return the device
  32         on which the lock is set).
  33
  34     INPUTS
  35         name - The name of the DOS device, without the ':'.
  36
  37     RESULT
  38         Either a pointer to the Device structure, or NULL.
  39
  40     NOTES
  41         You should really use GetDeviceProc() as this function caters
  42         for all possible device types.
  43
  44     EXAMPLE
  45
  46     BUGS
  47         Does not support late- and non-bound assigns, or multiple
  48         path assigns very well.
  49
  50     SEE ALSO
  51         GetDeviceProc(), FreeDeviceProc()
  52
  53     INTERNALS
  54
  55 *****************************************************************************/
  56 {
  57     AROS_LIBFUNC_INIT
  58
  59     struct MsgPort *res = NULL;
  60     struct DevProc *dvp;
  61
  62     /* just use GetDeviceProc(), it knows everything useful anyway */
  63     if ((dvp = GetDeviceProc(name, NULL)) == NULL)
  64         return NULL;
  65
  66     /* if GetDeviceProc() had to create the lock (ie non-binding assigns), we
  67      * can't return it as there's no cleanup function, so we have to error */
  68     if (dvp->dvp_Flags & DVPF_UNLOCK) {
  69         FreeDeviceProc(dvp);
  70         SetIoErr(ERROR_DEVICE_NOT_MOUNTED);
  71         return NULL;
  72     }
  73
  74     /* all good. get the lock and device */
  75     SetIoErr(dvp->dvp_Lock);
  76     res = dvp->dvp_Port;
  77
  78     FreeDeviceProc(dvp);
  79
  80     return res;
  81
  82     AROS_LIBFUNC_EXIT
  83 } /* DeviceProc */