rom/dos/makelink.c

   1 /*
   2     Copyright © 1995-2013, 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(SIPTR,   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
  56     SEE ALSO
  57         ReadLink()
  58
  59     INTERNALS
  60
  61 *****************************************************************************/
  62 {
  63     AROS_LIBFUNC_INIT
  64
  65     struct PacketHelperStruct phs;
  66     LONG status;
  67
  68     status = DOSFALSE;
  69     if (getpacketinfo(DOSBase, name, &phs))
  70     {
  71         status = dopacket4(DOSBase, NULL, phs.port, ACTION_MAKE_LINK,
  72             phs.lock, phs.name, (SIPTR)dest, soft ? LINK_SOFT: LINK_HARD);
  73         freepacketinfo(DOSBase, &phs);
  74     }
  75
  76     return status;
  77
  78     AROS_LIBFUNC_EXIT
  79 } /* MakeLink */