<commit_before>.. hostsd - Hosts file updater daemon

   Copyright (C) 2014, <NAME> <<EMAIL>>
   All rights reserved.

   Redistribution and use in source and binary forms, with or without
   modification, are permitted provided that the following conditions
   are met:

   1. Redistributions of source code must retain the above
      copyright notice, this list of conditions and the following
      disclaimer.
   2. Redistributions in binary form must reproduce the above
      copyright notice, this list of conditions and the following
      disclaimer in the documentation and/or other materials
      provided with the distribution.

   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
   FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
   COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
   INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
   (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
   SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
   HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
   STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
   ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
   OF THE POSSIBILITY OF SUCH DAMAGE.

======
hostsd
======

-------------------------
Hosts file updater daemon
-------------------------

:Author: Written by <NAME>
:Version: 0.1
:Manual section: 8

SYNOPSIS
========

**hostsd** [-d *HOSTSD_DIR*] [-f *HOSTS_FILE*] [-p *PIDFILE*]

**hostsd** -h

DESCRIPTION
===========

With hostsd, it becomes possible to modularize the monolithic /etc/hosts file.
Put your hosts fragments in /etc/hosts.d, let hostsd monitor them and update
/etc/hosts for you.

The hostsd program isn't actually a **daemon**\ (3). It won't detach itself
from its terminal and run in the background. It is meant to run as a service,
and the init system should handle this behaviour.

OPTIONS
=======

**-d** *HOSTSD_DIR*
   The drop-in directory to watch. HOSTSD_DIR defaults to /etc/hosts.d
   but is not meant to be changed. It exists mainly for testing purposes
   but could prove useful to modularize /etc/hosts in a chroot environment.

**-f** *HOSTS_FILE*
   The hosts file to modularize. HOSTS_FILE defaults to /etc/hosts but is
   not meant to be changed. It exists mainly for testing purposes but could
   prove useful to modularize /etc/hosts in a chroot environment.

**-h**
   Displays hostsd's usage summary and exits.

**-p** *PIDFILE*
   Write the process's PID to the specified file. PIDFILE defaults to
   /var/run/hostsd.pid but is not meant to be changed. It exists mainly for
   testing purposes but could prove useful to modularize /etc/hosts in a
   chroot environment.

SEE ALSO
========

**hosts**\ (5)<commit_msg>factored the note on "defaults" in hostsd(8)<commit_after>.. hostsd - Hosts file updater daemon

   Copyright (C) 2014, <NAME> <<EMAIL>>
   All rights reserved.

   Redistribution and use in source and binary forms, with or without
   modification, are permitted provided that the following conditions
   are met:

   1. Redistributions of source code must retain the above
      copyright notice, this list of conditions and the following
      disclaimer.
   2. Redistributions in binary form must reproduce the above
      copyright notice, this list of conditions and the following
      disclaimer in the documentation and/or other materials
      provided with the distribution.

   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
   FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
   COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
   INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
   (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
   SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
   HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
   STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
   ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
   OF THE POSSIBILITY OF SUCH DAMAGE.

======
hostsd
======

-------------------------
Hosts file updater daemon
-------------------------

:Author: Written by <NAME>
:Version: 0.1
:Manual section: 8

SYNOPSIS
========

**hostsd** [-d *HOSTSD_DIR*] [-f *HOSTS_FILE*] [-p *PIDFILE*]

**hostsd** -h

DESCRIPTION
===========

With hostsd, it becomes possible to modularize the monolithic /etc/hosts file.
Put your hosts fragments in /etc/hosts.d, let hostsd monitor them and update
/etc/hosts for you.

The hostsd program isn't actually a **daemon**\ (3). It won't detach itself
from its terminal and run in the background. It is meant to run as a service,
and the init system should handle this behaviour.

OPTIONS
=======

.. |defaults| replace::

   but is not meant to be changed. It exists mainly for testing purposes but
   could prove useful to modularize /etc/hosts in a **chroot**\ (1) environment.

**-d** *HOSTSD_DIR*
   The drop-in directory to watch. HOSTSD_DIR defaults to /etc/hosts.d
   |defaults|

**-f** *HOSTS_FILE*
   The hosts file to modularize. HOSTS_FILE defaults to /etc/hosts |defaults|

**-h**
   Displays hostsd's usage summary and exits.

**-p** *PIDFILE*
   Write the process's PID to the specified file. PIDFILE defaults to
   /var/run/hostsd.pid |defaults|

SEE ALSO
========

**hosts**\ (5)
{'fraction_non_alphanumeric': 0.09572978648932447, 'fraction_numerical': 0.004200210010500525, 'mean_word_length': 3.4578783151326054, 'pattern_counts': {'":': 0, '<': 11, '<?xml version=': 0, '>': 11, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4071004', 'n_tokens_mistral': 1684, 'n_tokens_neox': 1523, 'n_words': 775}