salt.states.host

### Navigation

- index
- modules |
- next |
- previous |
- « SaltStack.org |
- Documentation home
- Full list of builtin state modules »

# salt.states.host

## Management of addresses and names in hosts file.

The /etc/hosts file can be managed to contain definitions for specific hosts:

    salt-master:
      host.present:
        - ip: 192.168.0.42

Or using the "names:" directive, you can put several names for the same IP. (Do not try one name with space-seperated values).

    server1:
      host.present:
        - ip: 192.168.0.42
        - names:
          - server1
          - florida

NOTE: changing the IP or name(s) in the present() function does not cause an update to remove the old entry.

`salt.states.host.` `absent`(name, ip)

  Ensure that the named host is absent

  name
    The host to remove
  ip
    The ip addr of the host to remove

`salt.states.host.` `present`(name, ip)

  Ensures that the named host is present with the given ip

  name
    The host to assign an ip to
  ip
    The ip addr to apply to the host

## Comments

comments powered by Disqus

### Navigation

- index
- modules |
- next |
- previous |
- « SaltStack.org |
- Documentation home
- Full list of builtin state modules »