Puppet Class: avahi

Inherits:
avahi::params
Defined in:
manifests/init.pp

Overview

Installs and configures Avahi.

Examples:

Declaring the class

include dbus
include avahi

Parameters:

  • conf_dir (Stdlib::Absolutepath) (defaults to: $avahi::params::conf_dir) —

    The top-level configuration directory, usually /etc/avahi.

  • dtd_dir (Stdlib::Absolutepath) (defaults to: $avahi::params::dtd_dir) —

    The directory containing the XML DTD for service validation.

  • group (String) (defaults to: $avahi::params::group) —

    The unprivileged group used to run the daemon.

  • package_name (String) (defaults to: $avahi::params::package_name) —

    The name of the package.

  • policy_group (String) (defaults to: $avahi::params::policy_group) —

    The group that is allowed by policy to set the mDNS hostname.

  • service_name (String) (defaults to: $avahi::params::service_name) —

    The service name.

  • user (String) (defaults to: $avahi::params::user) —

    The unprivileged user used to run the daemon.

  • validate (Boolean) (defaults to: $avahi::params::validate) —

    Whether to try and validate service files prior to installing them.

  • xmllint (Stdlib::Absolutepath) (defaults to: $avahi::params::xmllint) —

    The path to the xmllint binary used to validate service files.

  • add_service_cookie (Optional[Boolean]) (defaults to: undef) —

    Whether a unique cookie is added to all locally registered services.

  • allow_interfaces (Optional[Array[String, 1]]) (defaults to: undef) —

    Interfaces to allow mDNS traffic on.

  • allow_point_to_point (Optional[Boolean]) (defaults to: undef) —

    Include Point-to-Point interfaces.

  • browse_domains (Optional[Array[Bodgitlib::Domain, 1]]) (defaults to: $avahi::params::browse_domains) —

    Additional browse domains.

  • cache_entries_max (Optional[Integer[0]]) (defaults to: undef) —

    How many entries are cached per interface.

  • check_response_ttl (Optional[Boolean]) (defaults to: undef) —

    Whether to check the TTL of mDNS packets.

  • clients_max (Optional[Integer[0]]) (defaults to: undef) —

    Maximum number of D-Bus clients permitted.

  • deny_interfaces (Optional[Array[String, 1]]) (defaults to: undef) —

    Interfaces to explicitly deny mDNS traffic on.

  • disable_publishing (Optional[Boolean]) (defaults to: undef) —

    Disable publishing of any records.

  • disable_user_service_publishing (Optional[Boolean]) (defaults to: undef) —

    Disable publishing of records by user applications.

  • disallow_other_stacks (Optional[Boolean]) (defaults to: undef) —

    Whether to allow other mDNS stacks to run on the host.

  • domain_name (Optional[String]) (defaults to: undef) —

    Override the domain name used, .local normally.

  • enable_dbus (Optional[Boolean]) (defaults to: undef) —

    Whether to connect to D-Bus.

  • enable_reflector (Optional[Boolean]) (defaults to: undef) —

    Whether to enable the mDNS reflector.

  • enable_wide_area (Optional[Boolean]) (defaults to: $avahi::params::enable_wide_area) —

    Enable wide-area mDNS.

  • entries_per_entry_group_max (Optional[Integer[0]]) (defaults to: undef) —

    The maximum number of entries to be registered by a single D-Bus client.

  • host_name (Optional[String]) (defaults to: undef) —

    Override the hostname used for the local machine.

  • objects_per_client_max (Optional[Integer[0]]) (defaults to: undef) —

    The maximum number of objects to be registered by a single D-Bus client.

  • publish_aaaa_on_ipv4 (Optional[Boolean]) (defaults to: undef) —

    Whether to publish AAAA records via IPv4.

  • publish_a_on_ipv6 (Optional[Boolean]) (defaults to: undef) —

    Whether to publish A records via IPv6.

  • publish_addresses (Optional[Boolean]) (defaults to: undef) —

    Whether to publish mDNS address records for all local IP addresses.

  • publish_dns_servers (Optional[Array[Stdlib::IP::Address::NoSubnet, 1]]) (defaults to: undef) —

    List of unicast DNS servers to publish in mDNS.

  • publish_domain (Optional[Boolean]) (defaults to: undef) —

    Whether to announce the local domain name for browsing by other hosts.

  • publish_hinfo (Optional[Boolean]) (defaults to: $avahi::params::publish_hinfo) —

    Whether to publish HINFO records on all interfaces.

  • publish_resolv_conf_dns_servers (Optional[Boolean]) (defaults to: undef) —

    Whether to publish the DNS servers listed in /etc/resolv.conf in addition to any listed in publish_dns_servers.

  • publish_workstation (Optional[Boolean]) (defaults to: $avahi::params::publish_workstation) —

    Whether to publish a workstation record for the local machine.

  • ratelimit_burst (Optional[Integer[0]]) (defaults to: $avahi::params::ratelimit_burst) —

    Per-interface packet rate-limiting burst parameter.

  • ratelimit_interval_usec (Optional[Integer[0]]) (defaults to: $avahi::params::ratelimit_interval_usec) —

    Per-interface packet rate-limiting interval parameter.

  • reflect_ipv (Optional[Boolean]) (defaults to: undef) —

    Whether to reflect between IPv4 and IPv6.

  • rlimit_as (Optional[Integer[0]]) (defaults to: undef) —

    Value in bytes for RLIMIT_AS.

  • rlimit_core (Optional[Integer[0]]) (defaults to: $avahi::params::rlimit_core) —

    Value in bytes for RLIMIT_CORE.

  • rlimit_data (Optional[Integer[0]]) (defaults to: $avahi::params::rlimit_data) —

    Value in bytes for RLIMIT_DATA.

  • rlimit_fsize (Optional[Integer[0]]) (defaults to: $avahi::params::rlimit_fsize) —

    Value for RLIMIT_FSIZE.

  • rlimit_nofile (Optional[Integer[0]]) (defaults to: $avahi::params::rlimit_nofile) —

    Value for RLIMIT_NOFILE.

  • rlimit_nproc (Optional[Integer[2]]) (defaults to: $avahi::params::rlimit_nproc)
  • rlimit_stack (Optional[Integer[0]]) (defaults to: $avahi::params::rlimit_stack)
  • use_iff_running (Optional[Boolean]) (defaults to: undef)
  • use_ipv4 (Optional[Boolean]) (defaults to: $avahi::params::use_ipv4)
  • use_ipv6 (Optional[Boolean]) (defaults to: $avahi::params::use_ipv6)

See Also:



70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
 
# File 'manifests/init.pp', line 70

class avahi (
  Stdlib::Absolutepath                              $conf_dir                        = $avahi::params::conf_dir,
  Stdlib::Absolutepath                              $dtd_dir                         = $avahi::params::dtd_dir,
  String                                            $group                           = $avahi::params::group,
  String                                            $package_name                    = $avahi::params::package_name,
  String                                            $policy_group                    = $avahi::params::policy_group,
  String                                            $service_name                    = $avahi::params::service_name,
  String                                            $user                            = $avahi::params::user,
  Boolean                                           $validate                        = $avahi::params::validate,
  Stdlib::Absolutepath                              $xmllint                         = $avahi::params::xmllint,
  Optional[Boolean]                                 $add_service_cookie              = undef,
  Optional[Array[String, 1]]                        $allow_interfaces                = undef,
  Optional[Boolean]                                 $allow_point_to_point            = undef,
  Optional[Array[Bodgitlib::Domain, 1]]             $browse_domains                  = $avahi::params::browse_domains,
  Optional[Integer[0]]                              $cache_entries_max               = undef,
  Optional[Boolean]                                 $check_response_ttl              = undef,
  Optional[Integer[0]]                              $clients_max                     = undef,
  Optional[Array[String, 1]]                        $deny_interfaces                 = undef,
  Optional[Boolean]                                 $disable_publishing              = undef,
  Optional[Boolean]                                 $disable_user_service_publishing = undef,
  Optional[Boolean]                                 $disallow_other_stacks           = undef,
  Optional[String]                                  $domain_name                     = undef,
  Optional[Boolean]                                 $enable_dbus                     = undef,
  Optional[Boolean]                                 $enable_reflector                = undef,
  Optional[Boolean]                                 $enable_wide_area                = $avahi::params::enable_wide_area,
  Optional[Integer[0]]                              $entries_per_entry_group_max     = undef,
  Optional[String]                                  $host_name                       = undef,
  Optional[Integer[0]]                              $objects_per_client_max          = undef,
  Optional[Boolean]                                 $publish_aaaa_on_ipv4            = undef,
  Optional[Boolean]                                 $publish_a_on_ipv6               = undef,
  Optional[Boolean]                                 $publish_addresses               = undef,
  Optional[Array[Stdlib::IP::Address::NoSubnet, 1]] $publish_dns_servers             = undef,
  Optional[Boolean]                                 $publish_domain                  = undef,
  Optional[Boolean]                                 $publish_hinfo                   = $avahi::params::publish_hinfo,
  Optional[Boolean]                                 $publish_resolv_conf_dns_servers = undef,
  Optional[Boolean]                                 $publish_workstation             = $avahi::params::publish_workstation,
  Optional[Integer[0]]                              $ratelimit_burst                 = $avahi::params::ratelimit_burst,
  Optional[Integer[0]]                              $ratelimit_interval_usec         = $avahi::params::ratelimit_interval_usec,
  Optional[Boolean]                                 $reflect_ipv                     = undef,
  Optional[Integer[0]]                              $rlimit_as                       = undef,
  Optional[Integer[0]]                              $rlimit_core                     = $avahi::params::rlimit_core,
  Optional[Integer[0]]                              $rlimit_data                     = $avahi::params::rlimit_data,
  Optional[Integer[0]]                              $rlimit_fsize                    = $avahi::params::rlimit_fsize,
  Optional[Integer[0]]                              $rlimit_nofile                   = $avahi::params::rlimit_nofile,
  Optional[Integer[2]]                              $rlimit_nproc                    = $avahi::params::rlimit_nproc,
  Optional[Integer[0]]                              $rlimit_stack                    = $avahi::params::rlimit_stack,
  Optional[Boolean]                                 $use_iff_running                 = undef,
  Optional[Boolean]                                 $use_ipv4                        = $avahi::params::use_ipv4,
  Optional[Boolean]                                 $use_ipv6                        = $avahi::params::use_ipv6,
) inherits avahi::params {

  contain avahi::install
  contain avahi::config
  contain avahi::daemon

  Class['avahi::install'] ~> Class['avahi::config'] ~> Class['avahi::daemon']
}