Documentation du Dr FRAPPE

Ce wiki regroupe les résultats de mes expériences en informatique accumulés au cours de mes recherches sur le net.

Dans la mesure du possible, j'ai cité mes sources ; il en manque certainement… :-)

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision
Révision précédente
Prochaine révisionLes deux révisions suivantes
logiciel:internet:dnsmasq:dnsmasq.conf [2020/11/05 20:41] – [Options] adminlogiciel:internet:dnsmasq:dnsmasq.conf [2021/02/17 10:07] – ↷ Page déplacée de fr:logiciel:internet:dnsmasq:dnsmasq.conf à logiciel:internet:dnsmasq:dnsmasq.conf admin
Ligne 5: Ligne 5:
 ====== Format ====== ====== Format ======
  
-Une option par ligne+Une option par ligne :<code txt ><option>=<valeur></code>
  
 les options valides sont les mêmes que celles sur la ligne de commande. les options valides sont les mêmes que celles sur la ligne de commande.
Ligne 290: Ligne 290:
     ? pxe-prompt="Press F8 for menu.", 60     ? pxe-prompt="Press F8 for menu.", 60
     : or with timeout before first available action is taken:     : or with timeout before first available action is taken:
- +  ? pxe-service 
-Available boot services. for PXE. +  : 
-#pxe-service=x86PC, "Boot from local disk+    ? pxe-service=x86PC, "Boot from local disk" 
- +    : Available boot services. for PXE. 
-Loads <tftp-root>/pxelinux.0 from dnsmasq TFTP server. +    ? pxe-service=x86PC, "Install Linux", pxelinux 
-#pxe-service=x86PC, "Install Linux", pxelinux +    : Loads <tftp-root>/pxelinux.0 from dnsmasq TFTP server. 
- +    ? pxe-service=x86PC, "Install Linux", pxelinux, 1.2.3.4 
-Loads <tftp-root>/pxelinux.0 from TFTP server at 1.2.3.4. +    : Loads <tftp-root>/pxelinux.0 from TFTP server at 1.2.3.4. 
-Beware this fails on old PXE ROMS. +    : Beware this fails on old PXE ROMS. 
-#pxe-service=x86PC, "Install Linux", pxelinux, 1.2.3.4 +    ? pxe-service=x86PC, "Install windows from RIS server", 1 
- +    : Use bootserver on network, found my multicast or broadcast. 
-Use bootserver on network, found my multicast or broadcast. +    ? pxe-service=x86PC, "Install windows from RIS server", 1, 1.2.3.4 
-#pxe-service=x86PC, "Install windows from RIS server",+    : Use bootserver at a known IP address. 
- +  ? multicast-FTP 
-Use bootserver at a known IP address. +  : If you have multicast-FTP available, information for that can be passed in a similar way using options 1 to 5. See page 19 of http://download.intel.com/design/archives/wfm/downloads/pxespec.pdf 
-#pxe-service=x86PC, "Install windows from RIS server", 1, 1.2.3.4 +    ? enable-tftp 
- +    : Enable dnsmasq's built-in TFTP server 
-If you have multicast-FTP available, +    ? tftp-root=/var/ftpd 
-information for that can be passed in a similar way using options 1 +    : Set the root directory for files available via FTP. 
-to 5. See page 19 of +    ? tftp-no-fail 
-http://download.intel.com/design/archives/wfm/downloads/pxespec.pdf +    : Do not abort if the tftp-root is unavailable 
- +    ? tftp-secure 
- +    : Make the TFTP server more secure: with this set, only files owned by the user dnsmasq is running as will be send over the net. 
-Enable dnsmasq's built-in TFTP server +    ? tftp-no-blocksize 
-#enable-tftp +    : This option stops dnsmasq from negotiating a larger blocksize for TFTP transfers. It will slow things down, but may rescue some broken TFTP clients. 
- +  ? dhcp-boot 
-Set the root directory for files available via FTP. +  : 
-#tftp-root=/var/ftpd +    ? dhcp-boot=tag:red,pxelinux.red-net 
- +    : Set the boot file name only when the "red" tag is set. 
-Do not abort if the tftp-root is unavailable +    ? dhcp-boot=/var/ftpd/pxelinux.0,boothost,192.168.0.3 
-#tftp-no-fail +    : An example of dhcp-boot with an external TFTP server: the name and IP address of the server are given after the filename. 
- +    : Can fail with old PXE ROMS. Overridden by --pxe-service. 
-Make the TFTP server more secure: with this set, only files owned by +    ? dhcp-boot=/var/ftpd/pxelinux.0,boothost,tftp_server_name 
-the user dnsmasq is running as will be send over the net. +    : If there are multiple external tftp servers having a same name (using /etc/hosts) then that name can be specified as the tftp_servername (the third option to dhcp-boot) and in that case dnsmasq resolves this name and returns the resultant IP addresses in round robin fashion. This facility can be used to load balance the tftp load among a set of servers. 
-#tftp-secure +  ? dhcp-lease 
- +  :  
-This option stops dnsmasq from negotiating a larger blocksize for TFTP +    ? dhcp-lease-max=150 
-transfers. It will slow things down, but may rescue some broken TFTP +    : Set the limit on DHCP leases, the default is 150 
-clients. +    ? dhcp-leasefile=/var/lib/misc/dnsmasq.leases 
-#tftp-no-blocksize +    : The DHCP server needs somewhere on disk to keep its lease database. 
- +    : This defaults to a sane location, but if you want to change it, use the line below. 
-Set the boot file name only when the "red" tag is set. +  ? dhcp-authoritative 
-#dhcp-boot=tag:red,pxelinux.red-net +  : Set the DHCP server to authoritative mode. In this mode it will barge in and take over the lease for any client which broadcasts on the network, whether it has a record of the lease or not. This avoids long timeouts when a machine wakes up on a new network. DO NOT enable this if there's the slightest chance that you might end up accidentally configuring a DHCP server for your campus/company accidentally. The ISC server uses the same option, and this URL provides more information: http://www.isc.org/files/auth.html 
- +  ? dhcp-rapid-commit 
-An example of dhcp-boot with an external TFTP server: the name and IP +  : Set the DHCP server to enable DHCPv4 Rapid Commit Option per RFC 4039. 
-address of the server are given after the filename. +  : In this mode it will respond to a DHCPDISCOVER message including a Rapid Commit option with a DHCPACK including a Rapid Commit option and fully committed address and configuration information. This must only be enabled if either the server is the only server for the subnet, or multiple servers are present and they each commit a binding for all clients. 
-Can fail with old PXE ROMS. Overridden by --pxe-service. +  ? dhcp-script=/bin/echo 
-#dhcp-boot=/var/ftpd/pxelinux.0,boothost,192.168.0.3 +  : Run an executable when a DHCP lease is created or destroyed. 
- +  : The arguments sent to the script are "add" or "del", then the MAC address, the IP address and finally the hostname if there is one. 
-If there are multiple external tftp servers having a same name +  ? cache-size=150 
-(using /etc/hosts) then that name can be specified as the +  : Set the cachesize here. 
-tftp_servername (the third option to dhcp-boot) and in that +  ? no-negcache 
-case dnsmasq resolves this name and returns the resultant IP +  : If you want to disable negative caching, uncomment this. 
-addresses in round robin fashion. This facility can be used to +  ? local-ttl= 
-load balance the tftp load among a set of servers. +   Normally responses which come from /etc/hosts and the DHCP lease file have Time-To-Live set as zero, which conventionally means do not cache further. If you are happy to trade lower load on the server for potentially stale date, you can set a time-to-live (in seconds) here. 
-#dhcp-boot=/var/ftpd/pxelinux.0,boothost,tftp_server_name +  ? bogus-nxdomain=64.94.110.11 
- +  : If you want dnsmasq to detect attempts by Verisign to send queries to unregistered .com and .net hosts to its sitefinder service and have dnsmasq instead return the correct NXDOMAIN response, uncomment this line. You can add similar lines to do the same for other registries which have implemented wildcard A records. 
-Set the limit on DHCP leases, the default is 150 +  ? alias 
-#dhcp-lease-max=150 +  : If you want to fix up DNS results from upstream servers, use the alias option. This only works for IPv4. 
- +    ? alias=1.2.3.4,5.6.7.8 
-The DHCP server needs somewhere on disk to keep its lease database. +    : This alias makes a result of 1.2.3.4 appear as 5.6.7.8 
-This defaults to a sane location, but if you want to change it, use +    ? alias=1.2.3.0,5.6.7.0,255.255.255.0 
-the line below. +    : and this maps 1.2.3.x to 5.6.7.x 
-#dhcp-leasefile=/var/lib/misc/dnsmasq.leases +    ? alias=192.168.0.10-192.168.0.40,10.0.0.0,255.255.255.0 
- +    : and this maps 192.168.0.10->192.168.0.40 to 10.0.0.10->10.0.0.40 
-Set the DHCP server to authoritative mode. In this mode it will barge in +  ? MX records 
-and take over the lease for any client which broadcasts on the network, +  : Change these lines if you want dnsmasq to serve MX records. 
-whether it has a record of the lease or not. This avoids long timeouts +    ? mx-host=maildomain.com,servermachine.com,50 
-when a machine wakes up on a new network. DO NOT enable this if there's +    : Return an MX record named "maildomain.com" with target servermachine.com and preference 50 
-the slightest chance that you might end up accidentally configuring a DHCP +    ? mx-target=servermachine.com 
-server for your campus/company accidentally. The ISC server uses +    : Set the default target for MX records created using the localmx option. 
-the same option, and this URL provides more information: +    ? localmx 
-http://www.isc.org/files/auth.html +    : Return an MX record pointing to the mx-target for all local machines. 
-#dhcp-authoritative +    ? selfmx 
- +    : Return an MX record pointing to itself for all local machines. 
-Set the DHCP server to enable DHCPv4 Rapid Commit Option per RFC 4039. +  ? srv-host 
-In this mode it will respond to a DHCPDISCOVER message including a Rapid Commit +  : Change the following lines if you want dnsmasq to serve SRV records. These are useful if you want to serve ldap requests for Active Directory and other windows-originated DNS requests. 
-option with a DHCPACK including a Rapid Commit option and fully committed address +  : See RFC 2782. 
-and configuration information. This must only be enabled if either the server is  +  : You may add multiple srv-host lines. 
-the only server for the subnet, or multiple servers are present and they each +  : The fields are <name>,<target>,<port>,<priority>,<weight> 
-commit a binding for all clients. +  : If the domain part if missing from the name (so that is just has the service and protocol sections) then the domain given by the domain= config option is used. (Note that expand-hosts does not need to be set for this to work.) 
-#dhcp-rapid-commit +    ? srv-host=_ldap._tcp.example.com,ldapserver.example.com,389 
- +    : A SRV record sending LDAP for the example.com domain to ldapserver.example.com port 389 
-Run an executable when a DHCP lease is created or destroyed. +    ? domain=example.com\\ srv-host=_ldap._tcp,ldapserver.example.com,389 
-The arguments sent to the script are "add" or "del", +    : A SRV record sending LDAP for the example.com domain to ldapserver.example.com port 389 (using domain=) 
-then the MAC address, the IP address and finally the hostname +    ? srv-host=_ldap._tcp.example.com,ldapserver.example.com,389,1\\ srv-host=_ldap._tcp.example.com,ldapserver.example.com,389,2 
-if there is one. +    : Two SRV records for LDAP, each with different priorities 
-#dhcp-script=/bin/echo +    ? srv-host=_ldap._tcp.example.com 
- +    : A SRV record indicating that there is no LDAP server for the domain example.com 
-Set the cachesize here. +  ? ptr-record=_http._tcp.dns-sd-services,"New Employee Page._http._tcp.dns-sd-services" 
-#cache-size=150 +  : The following line shows how to make dnsmasq serve an arbitrary PTR record. This is useful for DNS-SD. (Note that the domain-name expansion done for SRV records _does_not occur for PTR records.) 
- +  ? txt-record 
-If you want to disable negative caching, uncomment this. +  : Change the following lines to enable dnsmasq to serve TXT records. 
-#no-negcache +  : These are used for things like SPF and zeroconf. (Note that the domain-name expansion done for SRV records _does_not occur for TXT records.) 
- +    ? txt-record=example.com,"v=spf1 a -all" 
-Normally responses which come from /etc/hosts and the DHCP lease +    : Example SPF. 
-file have Time-To-Live set as zero, which conventionally means +    ? txt-record=_http._tcp.example.com,name=value,paper=A4 
-do not cache further. If you are happy to trade lower load on the +    : Example zeroconf 
-server for potentially stale date, you can set a time-to-live (in +  ? cname=bertand,bert 
-seconds) here. +  : Provide an alias for a "local" DNS name. Note that this _only_ works for targets which are names from DHCP or /etc/hosts. Give host "bert" another name, bertrand 
-#local-ttl+  ? log-queries 
- +  : For debugging purposes, log each DNS query as it passes through dnsmasq. 
-If you want dnsmasq to detect attempts by Verisign to send queries +  ? log-dhcp 
-to unregistered .com and .net hosts to its sitefinder service and +  : Log lots of extra information about DHCP transactions. 
-have dnsmasq instead return the correct NXDOMAIN response, uncomment +  ? conf-file=/etc/dnsmasq.more.conf 
-this line. You can add similar lines to do the same for other +  ? conf-dir=/etc/dnsmasq.d 
-registries which have implemented wildcard A records. +  : Include another lot of configuration options. 
-#bogus-nxdomain=64.94.110.11 +  ? conf-dir=/etc/dnsmasq.d,.bak 
- +  : Include all the files in a directory except those ending in .bak 
-If you want to fix up DNS results from upstream servers, use the +  ? conf-dir=/etc/dnsmasq.d/,*.conf 
-alias option. This only works for IPv4. +  : Include all files in a directory which end in .conf 
-This alias makes a result of 1.2.3.4 appear as 5.6.7.8 +  ? dhcp-name-match=set:wpad-ignore,wpad 
-#alias=1.2.3.4,5.6.7.8 +  ? dhcp-ignore-names=tag:wpad-ignore 
-and this maps 1.2.3.x to 5.6.7.x +  : If a DHCP client claims that its name is "wpad", ignore that. 
-#alias=1.2.3.0,5.6.7.0,255.255.255.0 +  : This fixes a security hole. see CERT Vulnerability VU#598349
-and this maps 192.168.0.10->192.168.0.40 to 10.0.0.10->10.0.0.40 +
-#alias=192.168.0.10-192.168.0.40,10.0.0.0,255.255.255.0 +
- +
-Change these lines if you want dnsmasq to serve MX records. +
- +
-Return an MX record named "maildomain.com" with target +
-servermachine.com and preference 50 +
-#mx-host=maildomain.com,servermachine.com,50 +
- +
-Set the default target for MX records created using the localmx option. +
-#mx-target=servermachine.com +
- +
-Return an MX record pointing to the mx-target for all local +
-machines. +
-#localmx +
- +
-Return an MX record pointing to itself for all local machines. +
-#selfmx +
- +
-Change the following lines if you want dnsmasq to serve SRV +
-records.  These are useful if you want to serve ldap requests for +
-Active Directory and other windows-originated DNS requests. +
-See RFC 2782. +
-You may add multiple srv-host lines. +
-The fields are <name>,<target>,<port>,<priority>,<weight> +
-If the domain part if missing from the name (so that is just has the +
-service and protocol sections) then the domain given by the domain= +
-config option is used. (Note that expand-hosts does not need to be +
-set for this to work.) +
- +
-A SRV record sending LDAP for the example.com domain to +
-ldapserver.example.com port 389 +
-#srv-host=_ldap._tcp.example.com,ldapserver.example.com,389 +
- +
-A SRV record sending LDAP for the example.com domain to +
-ldapserver.example.com port 389 (using domain=) +
-#domain=example.com +
-#srv-host=_ldap._tcp,ldapserver.example.com,389 +
- +
-# Two SRV records for LDAPeach with different priorities +
-#srv-host=_ldap._tcp.example.com,ldapserver.example.com,389,1 +
-#srv-host=_ldap._tcp.example.com,ldapserver.example.com,389,2 +
- +
-A SRV record indicating that there is no LDAP server for the domain +
-example.com +
-#srv-host=_ldap._tcp.example.com +
- +
-The following line shows how to make dnsmasq serve an arbitrary PTR +
-record. This is useful for DNS-SD. (Note that the +
-domain-name expansion done for SRV records _does_not +
-occur for PTR records.) +
-#ptr-record=_http._tcp.dns-sd-services,"New Employee Page._http._tcp.dns-sd-services" +
- +
-Change the following lines to enable dnsmasq to serve TXT records. +
-These are used for things like SPF and zeroconf. (Note that the +
-domain-name expansion done for SRV records _does_not +
-occur for TXT records.) +
- +
-#Example SPF. +
-#txt-record=example.com,"v=spf1 a -all" +
- +
-#Example zeroconf +
-#txt-record=_http._tcp.example.com,name=value,paper=A4 +
- +
-Provide an alias for a "local" DNS name. Note that this _only_ works +
-for targets which are names from DHCP or /etc/hosts. Give host +
-"bert" another name, bertrand +
-#cname=bertand,bert +
- +
-For debugging purposes, log each DNS query as it passes through +
-dnsmasq. +
-#log-queries +
- +
-Log lots of extra information about DHCP transactions. +
-#log-dhcp +
- +
-# Include another lot of configuration options. +
-#conf-file=/etc/dnsmasq.more.conf +
-#conf-dir=/etc/dnsmasq.d +
- +
-Include all the files in a directory except those ending in .bak +
-#conf-dir=/etc/dnsmasq.d,.bak +
- +
-Include all files in a directory which end in .conf +
-#conf-dir=/etc/dnsmasq.d/,*.conf +
- +
-If a DHCP client claims that its name is "wpad", ignore that. +
-This fixes a security hole. see CERT Vulnerability VU#598349 +
-#dhcp-name-match=set:wpad-ignore,wpad +
-#dhcp-ignore-names=tag:wpad-ignore+
  
 ====== Voir aussi ====== ====== Voir aussi ======