# 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-separated values).

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

NOTE: changing the 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

Current Salt release: 0.17.1

### Table Of Contents

- salt.states.host
  - Management of addresses and names in hosts file.

#### Previous topic

salt.states.hg

#### Next topic

salt.states.iptables

### Quick search

Enter search terms or a module, class or function name.

### Upcoming SaltStack Events

My conferences on Lanyrd