---
name: "cdist-type__link"
section: "7"
platform: "linux"
package: "cdist"
version: "7.0.0-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/cdist-type__link"
---

# cdist-type\_\_link(7)

Manage links (hard and symbolic)

## NAME

cdist-type\_\_link - Manage links (hard and symbolic)

## DESCRIPTION

This cdist type allows you to manage hard and symbolic links. The given object id is the destination for the link.

## REQUIRED PARAMETERS

- **source**

  Specifies the link source.

- **type**

  Specifies the link type: Either hard or symbolic.

## OPTIONAL PARAMETERS

- **state**

  'present' or 'absent', defaults to 'present'

## MESSAGES

- **created \<destination\>**

  Link to destination was created.

- **removed \<destination\>**

  Link to destination was removed.

- **removed \<destination\> (directory)**

  Destination was removed because state is **present** and destination was directory.

- **removed \<destination\> (wrongsource)**

  Destination was removed because state is **present** and destination link source was wrong.

## EXAMPLES

```
# Create hard link of /etc/shadow
__link /root/shadow --source /etc/shadow --type hard
# Relative symbolic link
__link /etc/apache2/sites-enabled/www.test.ch   \
   --source ../sites-available/www.test.ch      \
   --type symbolic
# Absolute symbolic link
__link /opt/plone --source /home/services/plone --type symbolic
# Remove link
__link /opt/plone --state absent
```

## AUTHORS

Nico Schottelius \<*nico-cdist--@--schottelius.org*\>

## COPYING

Copyright (C) 2011-2012 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

## COPYRIGHT

ungleich GmbH 2021