rom/dos/format.c

   1 /*
   2     Copyright © 1995-2004, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Format a device.
   6 */
   7 #include <proto/exec.h>
   8 #include <dos/dosextens.h>
   9 #include <dos/filesystem.h>
  10 #include "dos_intern.h"
  11
  12 /*****************************************************************************
  13
  14     NAME */
  15 #include <proto/dos.h>
  16
  17         AROS_LH3(BOOL, Format,
  18
  19 /*  SYNOPSIS */
  20         AROS_LHA(CONST_STRPTR, devicename, D1),
  21         AROS_LHA(CONST_STRPTR, volumename, D2),
  22         AROS_LHA(ULONG,        dostype,    D3),
  23
  24 /*  LOCATION */
  25         struct DosLibrary *, DOSBase, 119, Dos)
  26
  27 /*  FUNCTION
  28         Initialise a filesystem for use by the system. This instructs
  29         a filesystem to write out the data that it uses to describe the
  30         device.
  31
  32         The device should already have been formatted.
  33
  34     INPUTS
  35         devicename      - Name of the device to format.
  36         volumename      - The name you wish the volume to be called.
  37         dostype         - The DOS type you wish on the disk.
  38
  39     RESULT
  40         != 0 if the format was successful, 0 otherwise.
  41
  42     NOTES
  43
  44     EXAMPLE
  45
  46     BUGS
  47
  48     SEE ALSO
  49
  50     INTERNALS
  51
  52 *****************************************************************************/
  53 {
  54     AROS_LIBFUNC_INIT
  55     AROS_LIBBASE_EXT_DECL(struct DosLibrary *,DOSBase)
  56
  57     BOOL            success = 0;
  58
  59     /* Get space for I/O request. Use stackspace for now. */
  60     struct IOFileSys iofs;
  61
  62     /* Prepare I/O request. */
  63     InitIOFS(&iofs, FSA_FORMAT, DOSBase);
  64
  65     iofs.IOFS.io_Device = GetDevice(devicename, &iofs.IOFS.io_Unit,
  66                                     DOSBase);
  67
  68     if (iofs.IOFS.io_Device == NULL)
  69     {
  70         return 0;
  71     }
  72
  73     iofs.io_Union.io_FORMAT.io_VolumeName = volumename;
  74     iofs.io_Union.io_FORMAT.io_DosType = dostype;
  75
  76     /* Send the request. */
  77     DosDoIO(&iofs.IOFS);
  78
  79     /* Set error code */
  80     if (iofs.io_DosError == 0)
  81     {
  82         success = 1;
  83     }
  84     else
  85     {
  86         SetIoErr(iofs.io_DosError);
  87     }
  88
  89     return success;
  90
  91     AROS_LIBFUNC_EXIT
  92 } /* Format */