.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "CDIST-TYPE__LINK" "7" "Sep 26, 2023" "7.0.0" "cdist"
.SH NAME
.sp
cdist\-type__link \- Manage links (hard and symbolic)
.SH DESCRIPTION
.sp
This cdist type allows you to manage hard and symbolic links.
The given object id is the destination for the link.
.SH REQUIRED PARAMETERS
.INDENT 0.0
.TP
.B source
Specifies the link source.
.TP
.B type
Specifies the link type: Either hard or symbolic.
.UNINDENT
.SH OPTIONAL PARAMETERS
.INDENT 0.0
.TP
.B state
\(aqpresent\(aq or \(aqabsent\(aq, defaults to \(aqpresent\(aq
.UNINDENT
.SH MESSAGES
.INDENT 0.0
.TP
.B created <destination>
Link to destination was created.
.TP
.B removed <destination>
Link to destination was removed.
.TP
.B removed <destination> (directory)
Destination was removed because state is \fBpresent\fP and destination was directory.
.TP
.B removed <destination> (wrongsource)
Destination was removed because state is \fBpresent\fP and destination link source was wrong.
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# 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   \e
   \-\-source ../sites\-available/www.test.ch      \e
   \-\-type symbolic

# Absolute symbolic link
__link /opt/plone \-\-source /home/services/plone \-\-type symbolic

# Remove link
__link /opt/plone \-\-state absent
.EE
.UNINDENT
.UNINDENT
.SH AUTHORS
.sp
Nico Schottelius <\fI\%nico\-cdist\-\-@\-\-schottelius.org\fP>
.SH COPYING
.sp
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.
.SH COPYRIGHT
ungleich GmbH 2021
.\" Generated by docutils manpage writer.
.