sortix-mirror/dnsconfig/dnsconfig.8

.Dd October 7, 2021
.Dt DNSCONFIG 8
.Os
.Sh NAME
.Nm dnsconfig
.Nd configure kernel DNS resolver list
.Sh SYNOPSIS
.Nm
.Nm
.Ar resolver ...
.Nm
.Fl s
.Op Ar resolver ...
.Nm
.Fl a
.Op Ar resolver ...
.Nm
.Fl d
.Op Ar resolver ...
.Sh DESCRIPTION
.Nm
writes the current kernel DNS resolver list, or modifies it if any resolvers are
specified.
.Pp
The options are as follows:
.Bl -tag -width "12345678"
.It Fl a
Append resolvers to the list.
.It Fl d
Delete resolvers from the list.
.It Fl s
Set the resolver list.
This option is the default if
.Nm
is invoked with any resolvers.
.El
.Sh EXIT STATUS
.Nm
will exit 0 on success and non-zero otherwise.
.Sh EXAMPLES
Get the resolvers:
.Bd -literal
$ dnsconfig
192.0.2.1
.Ed
.Pp
Set two resolvers:
.Bd -literal
# dnsconfig 192.0.2.15 192.0.2.100
# dnsconfig
192.0.2.15
192.0.2.100
.Ed
.Pp
Set the resolvers to the empty list:
.Bd -literal
# dnsconfig -s
# dnsconfig
.Ed
.Pp
Append a resolver:
.Bd -literal
# dnsconfig 192.0.2.128
# dnsconfig -a 192.0.2.40
# dnsconfig
192.0.2.128
192.0.2.40
.Ed
.Pp
Delete a resolver:
.Bd -literal
# dnsconfig -d 192.0.2.128
# dnsconfig
192.0.2.40
.Ed
.Sh SEE ALSO
.Xr getdnsconfig 2 ,
.Xr setdnsconfig 2 ,
.Xr inet 4 ,
.Xr dhclient 8 ,
.Xr ifconfig 8
.Sh HISTORY
.Nm
originally appeared in Sortix 1.1.
.Sh CAVEATS
The kernel DNS resolver list is global state.
Changes made with
.Nm
may be overwritten by other programs.
In particular
.Xr dhclient 8
sets the resolver list automatically unless otherwise configured.
Add dnsconfig(8). 2021-08-22 10:08:44 +00:00			`.Dd October 7, 2021`
			`.Dt DNSCONFIG 8`
			`.Os`
			`.Sh NAME`
			`.Nm dnsconfig`
			`.Nd configure kernel DNS resolver list`
			`.Sh SYNOPSIS`
			`.Nm`
			`.Nm`
			`.Ar resolver ...`
			`.Nm`
			`.Fl s`
			`.Op Ar resolver ...`
			`.Nm`
			`.Fl a`
			`.Op Ar resolver ...`
			`.Nm`
			`.Fl d`
			`.Op Ar resolver ...`
			`.Sh DESCRIPTION`
			`.Nm`
			`writes the current kernel DNS resolver list, or modifies it if any resolvers are`
			`specified.`
			`.Pp`
			`The options are as follows:`
			`.Bl -tag -width "12345678"`
			`.It Fl a`
			`Append resolvers to the list.`
			`.It Fl d`
			`Delete resolvers from the list.`
			`.It Fl s`
			`Set the resolver list.`
			`This option is the default if`
			`.Nm`
			`is invoked with any resolvers.`
			`.El`
			`.Sh EXIT STATUS`
			`.Nm`
			`will exit 0 on success and non-zero otherwise.`
			`.Sh EXAMPLES`
			`Get the resolvers:`
			`.Bd -literal`
			`$ dnsconfig`
			`192.0.2.1`
			`.Ed`
			`.Pp`
			`Set two resolvers:`
			`.Bd -literal`
			`# dnsconfig 192.0.2.15 192.0.2.100`
			`# dnsconfig`
			`192.0.2.15`
			`192.0.2.100`
			`.Ed`
			`.Pp`
			`Set the resolvers to the empty list:`
			`.Bd -literal`
			`# dnsconfig -s`
			`# dnsconfig`
			`.Ed`
			`.Pp`
			`Append a resolver:`
			`.Bd -literal`
			`# dnsconfig 192.0.2.128`
			`# dnsconfig -a 192.0.2.40`
			`# dnsconfig`
			`192.0.2.128`
			`192.0.2.40`
			`.Ed`
			`.Pp`
			`Delete a resolver:`
			`.Bd -literal`
			`# dnsconfig -d 192.0.2.128`
			`# dnsconfig`
			`192.0.2.40`
			`.Ed`
			`.Sh SEE ALSO`
			`.Xr getdnsconfig 2 ,`
Add networking stack. This change adds all the kernel parts of a network stack. The network stack is partial but implements many of the important parts. Add if(4) network interface abstraction. Network interfaces are registered in a global list that can be iterated and each assigned an unique integer identifier. Add reference counted packets with a cache that recycles recent packets. Add support for lo(4) loopback and ether(4) ethernet network interfaces. The /dev/lo0 loopback device is created automatically on boot. Add arp(4) address resolution protocol driver for translation of inet(4) network layer addresses into ether(4) link layer addresses. arp(4) entries are cached and evicted from the cache when needed or when the entry has not been used for a while. The cache is limited to 256 entries for now. Add ip(4) internet protocol version 4 support. IP fragmentation and options are not implemented yet. Add tcp(4) transmission control protocol sockets for a reliable transport layer protocol that provides a reliable byte stream connection between two hosts. The implementation is incomplete and does not yet implement out of band data, options, and high performance extensions. Add udp(4) user datagram protocol sockets for a connectionless transport layer that provides best-effort delivery of datagrams. Add ping(4) sockets for a best-effort delivery of echo datagrams. Change type of sa_family_t from unsigned short to uint16_t. Add --disable-network-drivers to the kernel(7) options and expose it with a bootloader menu. tix-iso-bootconfig can set this option by default. Import CRC32 code from libz for the Ethernet checksum. This is a compatible ABI change that adds features to socket(2) (AF_INET, IPPROTO_TCP, IPPROTO_UDP, IPPROTO_PING), the ioctls for if(4), socket options, and the lo0 loopback interface. This commit is based on work by Meisaka Yukara contributed as the commit bbf7f1e8a5238a2bd1fe8eb1d2cc5c9c2421e2c4. Almost no lines of this work remains in this final commit as it has been rewritten or refactored away over the years, see the individual file headers for which files contain remnants of this work. Co-authored-by: Meisaka Yukara <Meisaka.Yukara@gmail.com> 2022-12-04 23:35:21 +00:00			`.Xr setdnsconfig 2 ,`
Add ifconfig(8). Co-authored-by: Juhani Krekelä <juhani@krekelä.fi> 2017-06-30 21:11:16 +00:00			`.Xr inet 4 ,`
Add dhclient(8). Co-authored-by: Juhani Krekelä <juhani@krekelä.fi> 2023-02-17 22:31:57 +00:00			`.Xr dhclient 8 ,`
Add ifconfig(8). Co-authored-by: Juhani Krekelä <juhani@krekelä.fi> 2017-06-30 21:11:16 +00:00			`.Xr ifconfig 8`
Add dnsconfig(8). 2021-08-22 10:08:44 +00:00			`.Sh HISTORY`
			`.Nm`
			`originally appeared in Sortix 1.1.`
			`.Sh CAVEATS`
			`The kernel DNS resolver list is global state.`
			`Changes made with`
			`.Nm`
			`may be overwritten by other programs.`
Add dhclient(8). Co-authored-by: Juhani Krekelä <juhani@krekelä.fi> 2023-02-17 22:31:57 +00:00			`In particular`
			`.Xr dhclient 8`
			`sets the resolver list automatically unless otherwise configured.`