talexander/nixpkgs
1
0
Fork 0
Code Issues Pull Requests Releases Activity

networking: clarify search and domain option descriptions

Browse Source 
There is no canonical way to set a system domain name any longer. The one
we previously used was the NIS/YP one, but that is pointless these days.

The hostname is set up through /etc/hostname, but hostname(5) states that
it should only contain 64 7-bit ASCII characters, so it cannot be used
to cover the domain name.

We still support setting the domain name to complete the `fqdn` option
and as a central option to reference the domain name from. If anyone
wants a NIS/YP domain name set, do it yourself..

We then clarify that the domain option has nothing to do with DNS
resolution anymore and search should be configured instead.

Finally explain the purpose of the ndots option in the context of search
domains, since they decide when we stop considering the search domains
when querying names with more than one dot.
This commit is contained in:
Martin Weinelt 2025-07-04 22:58:51 +02:00
parent 8a4536fdaf
commit 8e70f11f88
No known key found for this signature in database
GPG Key ID: 87C1E9888F856759
1 changed files with 8 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
nixos/modules/tasks/network-interfaces.nix
View File

@ -707,7 +707,9 @@ in
];
type = types.listOf types.str;
description = ''
The list of search paths used when resolving domain names.
The list of domain search paths that are considered for resolving
hostnames with fewer dots than configured in the `ndots` option,
which defaults to 1 if unset.
'';
};
@ -716,7 +718,11 @@ in
example = "home.arpa";
type = types.nullOr types.str;
description = ''
The domain. It can be left empty if it is auto-detected through DHCP.
The system domain name. Used to populate the {option}`fqdn` value.
::: {.warning}
The domain name is not configured for DNS resolution purposes, see {option}`search` instead.
:::
'';
};