C.106 SymlinkTask

Creates symlink(s) to a specified file / directory or a collection of files / directories.

Table C.140: Attributes

NameTypeDescriptionDefaultRequired
targetStringWhat you're trying to symlink fromn/aYes (or nested FileSet)
linkStringWhere you'd like the symlink(s)n/aYes
overwriteBooleanWhether to override the symlink if it exists but points to a different locationfalseNo
relativeBooleanWhether to create relative symlinksfalseNo

C.106.1 Example

Single symlink

<symlink target="/path/to/original/file" link="/where/to/symlink" />

Using filesets

<symlink link="/where/to/symlink">
    <fileset dir="/some/directory">
        <include name="*" />
    </fileset>
</symlink>

In the fileset example, assuming the contents of "/some/directory" were:

  • Somedir

  • somefile

Then the contents of "/where/to/symlink" would be:

  • Somedir -> /some/directory/Somedir

  • somefile -> /some/directory/somefile

C.106.2 Supported Nested Tags