diff --git a/lib/App/Netdisco/Manual/Configuration.pod b/lib/App/Netdisco/Manual/Configuration.pod index 826e60ed..ead64d46 100644 --- a/lib/App/Netdisco/Manual/Configuration.pod +++ b/lib/App/Netdisco/Manual/Configuration.pod @@ -61,7 +61,7 @@ colon character). Access Control Lists (ACLs) appear in many places in the configuration file, used to select or exclude devices or hosts for certain settings. ACLs are a -YAML list of items, which can contain: +single item or YAML list of items, which can contain: =over 4 @@ -632,8 +632,7 @@ configuration. community: s3kr1t read: false write: true - only: - - 2001:db8::/32 + only: '2001:db8::/32' For SNMPv1 and SNMPv2, only the C key is required. Unlike the global C/C setting, this is not a list but a single @@ -641,7 +640,8 @@ item. To emulate their list behaviour, have multiple entries at the top C level, as in the example below. You can add C and/or C restrictions, and an IP restriction using -C. Giving the stanza a C name is optional, but recommended. +C (see L. Giving the stanza a C name is +optional, but recommended. For SNMPv3 the C and C keys are required. You can add C and/or C restrictions, and an IP restriction using C. Providing @@ -708,7 +708,8 @@ devices. For more fine-grained control see the C setting. =head3 C -Value: List of Network Identifiers or Device Properties. Default: Empty List. +Value: Single item or list of Network Identifiers or Device Properties. +Default: Empty List. IP addresses in the list will use C (and not C). See L for what you can use here. @@ -770,7 +771,8 @@ Number of times to retry connecting to a device before giving up. =head3 C -Value: List of Network Identifiers or Device Properties. Default: Empty List. +Value: Single item or list of Network Identifiers or Device Properties. +Default: Empty List. IP addresses in the list will not be visited during device discovery. See L for what you can use here. @@ -778,7 +780,8 @@ L for what you can use here. =head3 C -Value: List of Network Identifiers or Device Properties. Default: Empty List. +Value: Single item or list of Network Identifiers or Device Properties. +Default: Empty List. If present, device discovery will be limited to IP addresses matching entries in this list. See L for what you can use here. @@ -812,7 +815,8 @@ CONTROL LISTS"> for what you can use here. =head3 C -Value: List of Network Identifiers or Device Properties. Default: Empty List. +Value: Single item or list of Network Identifiers or Device Properties. +Default: Empty List. If present, macsuck will be limited to IP addresses matching entries in this list. See L for what you can use here. @@ -850,7 +854,8 @@ Similar to C, but allows specifying the device root =head3 C -Value: List of Network Identifiers or Device Properties. Default: Empty List. +Value: Single item or list of Network Identifiers or Device Properties. +Default: Empty List. Similar to C, but instead of skipping nodes on this device, they are allowed to gather on the upstream device port. Useful for devices which @@ -894,7 +899,8 @@ CONTROL LISTS"> for what you can use here. =head3 C -Value: List of Network Identifiers or Device Properties. Default: Empty List. +Value: Single item or list of Network Identifiers or Device Properties. +Default: Empty List. If present, arpnip will be limited to IP addresses matching entries in this list. See L for what you can use here. @@ -915,7 +921,7 @@ CONTROL LISTS"> for what you can use here. =head3 C -Value: List of Network Identifiers. Default: Empty List. +Value: Single item or list of Network Identifiers. Default: Empty List. If present, nbtstat will be limited to IP addresses matching entries in this list. See L for what you can use here. @@ -1006,8 +1012,9 @@ library default of 10. Similarly, the location of the Hosts file can be overridden in this config, or using the C environment variable. -C is a list of IP addresses or CIDR ranges to excluded from DNS -resolution. Link local addresses are excluded by default. +C is a single item or list of IP addresses or CIDR ranges to excluded from +DNS resolution (see L). Link local addresses are +excluded as in the defaults shown above. =head3 C diff --git a/lib/App/Netdisco/Util/DNS.pm b/lib/App/Netdisco/Util/DNS.pm index b6439168..a5147e6f 100644 --- a/lib/App/Netdisco/Util/DNS.pm +++ b/lib/App/Netdisco/Util/DNS.pm @@ -156,7 +156,7 @@ sub hostnames_resolve_async { =head2 no_resolve( $ip ) Given an IP address, returns true if excluded from DNS resolution by the -C configuration directive, otherwise returns false. +"C<< dns -> no >>" configuration directive, otherwise returns false. =cut