.\" Man page generated from reStructuredText.
.
.TH "CDIST-TYPE__HOSTS" "7" "Jun 23, 2019" "5.1.2" "cdist"
.
.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
..
.SH NAME
.sp
cdist\-type__hosts \- manage entries in /etc/hosts
.SH DESCRIPTION
.sp
Add or remove entries from \fI/etc/hosts\fP file.
.SH OPTIONAL PARAMETERS
.INDENT 0.0
.TP
.B state
If state is \fBpresent\fP, make \fIobject_id\fP resolve to \fIip\fP\&. If
state is \fBabsent\fP, \fIobject_id\fP will no longer resolve via
\fI/etc/hosts\fP, if it was previously configured with this type.
Manually inserted entries are unaffected.
.TP
.B ip
IP address, to which hostname (=\fIobject_id\fP) must resolve. If
state is \fBpresent\fP, this parameter is mandatory, if state is
\fBabsent\fP, this parameter is silently ignored.
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
# Now \(gafunny\(aq resolves to 192.168.1.76,
__hosts funny \-\-ip 192.168.1.76
# and \(gahappy\(aq no longer resolve via /etc/hosts if it was
# previously configured via __hosts.
__hosts happy \-\-state absent
.ft P
.fi
.UNINDENT
.UNINDENT
.SH SEE ALSO
.sp
\fBhosts\fP(5)
.SH AUTHORS
.sp
Dmitry Bogatov <\fI\%KAction@gnu.org\fP>
.SH COPYING
.sp
Copyright (C) 2015,2016 Dmitry Bogatov. Free use of this software is granted
under the terms of the GNU General Public License version 3 or later
(GPLv3+).
.SH COPYRIGHT
ungleich GmbH 2019
.\" Generated by docutils manpage writer.
.