rom/dos/format.c

   1 /*
   2     Copyright © 1995-2007, 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_intern.h"
  10
  11 /*****************************************************************************
  12
  13     NAME */
  14 #include <proto/dos.h>
  15
  16         AROS_LH3(BOOL, Format,
  17
  18 /*  SYNOPSIS */
  19         AROS_LHA(CONST_STRPTR, devicename, D1),
  20         AROS_LHA(CONST_STRPTR, volumename, D2),
  21         AROS_LHA(ULONG,        dostype,    D3),
  22
  23 /*  LOCATION */
  24         struct DosLibrary *, DOSBase, 119, Dos)
  25
  26 /*  FUNCTION
  27         Initialise a filesystem for use by the system. This instructs
  28         a filesystem to write out the data that it uses to describe the
  29         device.
  30
  31         The device should already have been formatted.
  32
  33     INPUTS
  34         devicename      - Name of the device to format.
  35         volumename      - The name you wish the volume to be called.
  36         dostype         - The DOS type you wish on the disk.
  37
  38     RESULT
  39         != 0 if the format was successful, 0 otherwise.
  40
  41     NOTES
  42
  43     EXAMPLE
  44
  45     BUGS
  46
  47     SEE ALSO
  48
  49     INTERNALS
  50
  51 *****************************************************************************/
  52 {
  53     AROS_LIBFUNC_INIT
  54
  55     struct PacketHelperStruct phs;
  56     LONG status = DOSFALSE;
  57
  58     if (!getdevpacketinfo(DOSBase, devicename, volumename, &phs))
  59         return DOSFALSE;
  60
  61     status = dopacket2(DOSBase, NULL, phs.port, ACTION_FORMAT, phs.name, (IPTR)dostype);
  62
  63     freepacketinfo(DOSBase, &phs);
  64
  65     return status;
  66
  67     AROS_LIBFUNC_EXIT
  68 } /* Format */