add manpages from tarent repo
[shellsnippets/shellsnippets.git] / mksh / sysadmin / mkhosts.1
1 .\" $Id: mkhosts.1 1814 2011-03-22 13:28:38Z tglase $
2 .Dd March 22, 2011
3 .Dt MKHOSTS 1
4 .Os
5 .Sh NAME
6 .Nm mkhosts
7 .Nd rename this computer
8 .Sh SYNOPSIS
9 .Nm
10 .Op Fl h Ar newname
11 .Op Fl i Ar ips
12 .Sh DESCRIPTION
13 The
14 .Nm
15 utility interactively asks for a new hostname
16 and installs it into the usual places, such as
17 .Pa /etc/hosts ,
18 .Pa /etc/hostname
19 or
20 .Pa /etc/sysconfig/network ,
21 and the kernel.
22 The
23 .Fl h
24 option uses
25 .Ar newname
26 as new hostname instead of asking interactively,
27 and aborts on error instead of repeatedly asking.
28 The
29 .Fl i
30 option with the
31 .Ar ips
32 argument, which contains comma-separated IPv4- and/or IPv6-addresses,
33 changes slightly the output format of
34 .Pa /etc/hosts
35 in that the
36 .Ar ips
37 given are mapped to the own hostname, and the loopback IP only to localhost.
38 Normally, the loopback IP maps to both the hostname and localhost, which is
39 desired in case the own IPs are unknown, for example retrieved via DHCP.
40 .Sh SEE ALSO
41 .Xr hostname 1 ,
42 .Xr hosts 5
43 .Sh AUTHORS
44 .An Thorsten Glaser Aq t.glaser@tarent.de