blob: 494a9e4ca14585797b155899609aa4099624a671 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
|
# Reference
<!-- DO NOT EDIT: This document was generated by Puppet Strings -->
## Table of Contents
### Resource types
* [`host`](#host): Installs and manages host entries.
## Resource types
### <a name="host"></a>`host`
For most systems, these entries will just be in `/etc/hosts`, but some
systems (notably OS X) will have different solutions.
#### Properties
The following properties are available in the `host` type.
##### `comment`
A comment that will be attached to the line with a # character.
##### `ensure`
Valid values: `present`, `absent`
The basic property that the resource should be in.
Default value: `present`
##### `host_aliases`
Any aliases the host might have. Multiple values must be
specified as an array.
##### `ip`
The host's IP address, IPv4 or IPv6.
##### `target`
The file in which to store service information. Only used by
those providers that write to disk. On most systems this defaults to `/etc/hosts`.
#### Parameters
The following parameters are available in the `host` type.
* [`name`](#-host--name)
* [`provider`](#-host--provider)
##### <a name="-host--name"></a>`name`
namevar
The host name.
##### <a name="-host--provider"></a>`provider`
The specific backend to use for this `host` resource. You will seldom need to specify this --- Puppet will usually
discover the appropriate provider for your platform.
|