rom/dos/makelink.c

   1 /*
   2     Copyright © 1995-2008, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc: Create a hard or soft link.
   6     Lang: English
   7 */
   8 #include <dos/dosextens.h>
   9 #include "dos_intern.h"
  10 #include <proto/exec.h>
  11
  12 /*****************************************************************************
  13
  14     NAME */
  15 #include <exec/types.h>
  16 #include <proto/dos.h>
  17
  18         AROS_LH3(LONG, MakeLink,
  19
  20 /*  SYNOPSIS */
  21         AROS_LHA(CONST_STRPTR, name, D1),
  22         AROS_LHA(APTR,   dest, D2),
  23         AROS_LHA(LONG  , soft, D3),
  24
  25 /*  LOCATION */
  26         struct DosLibrary *, DOSBase, 74, Dos)
  27
  28 /*  FUNCTION
  29         MakeLink() will create a link between two files or directories.
  30         A link is a filesystem object that refers to another file.
  31
  32         A soft link refers to another file or directory by name, and is
  33         resolved by the filesystem and the caller. Soft links are not
  34         restricted to the same volume and the target does not have to exist.
  35
  36         A hard link refers to another file by the location on a disk, and
  37         is resolved by the filesystem. Hard links are restricted to files
  38         or directories on the same volume.
  39
  40     INPUTS
  41         name - The name of the link to create
  42         dest - If 'soft' is TRUE this must be a filename; if it is FALSE a lock
  43                pointing to the file to be hard-linked must be provided
  44         soft - TRUE, if a soft link is to be created, FALSE for a hard link
  45
  46     RESULT
  47         boolean - DOSTRUE or DOSFALSE. On error, IoErr() will contain more
  48         information.
  49
  50     NOTES
  51
  52     EXAMPLE
  53
  54     BUGS
  55         Soft links were not working in the ROM filesystem before version
  56         37.
  57
  58     SEE ALSO
  59         ReadLink()
  60
  61     INTERNALS
  62         This function calls either FSA_CREATE_HARDLINK or FSA_CREATE_SOFTLINK
  63         on the filesystem of `name`.
  64
  65 *****************************************************************************/
  66 {
  67     AROS_LIBFUNC_INIT
  68
  69     struct PacketHelperStruct phs;
  70     LONG status;
  71
  72     status = DOSFALSE;
  73     if (getpacketinfo(DOSBase, name, &phs)) {
  74         status = dopacket4(DOSBase, NULL, phs.port, ACTION_MAKE_LINK, phs.lock, phs.name, (SIPTR)name, (IPTR)soft);
  75         freepacketinfo(DOSBase, &phs);
  76     }
  77
  78     return status;
  79
  80     AROS_LIBFUNC_EXIT
  81 } /* MakeLink */