From fc22b3d6507c6745911b9dfcc68f1e665ae13dbc Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 15 Apr 2024 21:43:11 +0200 Subject: Adding upstream version 4.22.0. Signed-off-by: Daniel Baumann --- upstream/opensuse-tumbleweed/man1/hostname.1 | 259 +++++++++++++++++++++++++++ 1 file changed, 259 insertions(+) create mode 100644 upstream/opensuse-tumbleweed/man1/hostname.1 (limited to 'upstream/opensuse-tumbleweed/man1/hostname.1') diff --git a/upstream/opensuse-tumbleweed/man1/hostname.1 b/upstream/opensuse-tumbleweed/man1/hostname.1 new file mode 100644 index 00000000..346c40b8 --- /dev/null +++ b/upstream/opensuse-tumbleweed/man1/hostname.1 @@ -0,0 +1,259 @@ +.TH HOSTNAME 1 "2009-09-16" "net-tools" "Linux Programmer's Manual" + +.SH NAME +hostname \- show or set the system's host name +.br +domainname \- show or set the system's NIS/YP domain name +.br +ypdomainname \- show or set the system's NIS/YP domain name +.br +nisdomainname \- show or set the system's NIS/YP domain name +.br +dnsdomainname \- show the system's DNS domain name +.br + +.SH SYNOPSIS +.B hostname +.RB [ \-a|\-\-alias ] +.RB [ \-d|\-\-domain ] +.RB [ \-f|\-\-fqdn|\-\-long ] +.RB [ \-A|\-\-all-fqdns ] +.RB [ \-i|\-\-ip-address ] +.RB [ \-I|\-\-all-ip-addresses ] +.RB [ \-s|\-\-short ] +.RB [ \-y|\-\-yp|\-\-nis ] +.br +.B hostname +.RB [ \-b|\-\-boot ] +.RB [ \-F|\-\-file\ filename ] +.RB [ hostname ] +.br +.B hostname +.RB [ \-h|\-\-help ] +.RB [ \-V|\-\-version ] +.PP +.B domainname +.RB [ nisdomain ] +.RB [ \-F\ file ] +.br +.B ypdomainname +.RB [ nisdomain ] +.RB [ \-F\ file ] +.br +.B nisdomainname +.RB [ nisdomain ] +.RB [ \-F\ file ] +.PP +.B dnsdomainname + +.SH DESCRIPTION +.B Hostname +is used to display the system's DNS name, and to display or set its hostname or +NIS domain name. + +.SS "GET NAME" +When called without any arguments, the program displays the current +names: +.LP +.B hostname +will print the name of the system as returned by the +.BR gethostname (2) +function. +.LP +.B domainname +will print the NIS domainname of the system. +.B domainname +uses the +.BR gethostname (2) +function, while +.B ypdomainname +and +.B nisdomainname +use the +.BR getdomainname (2). +.LP +.B dnsdomainname +will print the domain part of the FQDN (Fully Qualified Domain Name). The +complete FQDN of the system is returned with +.B hostname \-\-fqdn +(but see the warnings in section +.B THE FQDN +below). + +.SS "SET NAME" +When called with one argument or with the +.B \-\-file +option, the commands set the host name or the NIS/YP domain name. +.B hostname +uses the +.BR sethostname (2) +function, while all of the three +.BR domainname , +.B ypdomainname +and +.B nisdomainname +use +.BR setdomainname (2). +Note, that this is effective only until the next reboot. +Edit /etc/hostname for permanent change. +.LP +Note, that only the super-user can change the names. +.LP +It is not possible to set the FQDN or the DNS domain name with the +.B dnsdomainname +command (see +.B THE FQDN +below). +.LP +The host name is usually set once at system startup in +.I /etc/init.d/hostname.sh +(normally by reading the contents of a file which contains +the host name, e.g. +.IR /etc/hostname ). + +.SS THE FQDN +The FQDN (Fully Qualified Domain Name) of the system is the name that the +.BR resolver (3) +returns for the host name, such as, +.IR ursula.example.com . +It is usually the hostname followed by the DNS domain name (the part +after the first dot). You can check the FQDN using +.B hostname \-\-fqdn +or the domain name using +.BR "dnsdomainname" . +.LP +You cannot change the FQDN with +.B hostname +or +.BR dnsdomainname . +.LP +The recommended method of setting the FQDN is to make the hostname be +an alias for the fully qualified name using +.IR /etc/hosts , +DNS, or NIS. For example, if the hostname was "ursula", one might have a line in +.I /etc/hosts +which reads +.LP +.RS +127.0.1.1 ursula.example.com ursula +.RE +.LP +Technically: The FQDN is the name +.BR getaddrinfo (3) +returns for the host name returned by +.BR gethostname (2). +The DNS domain name is the part after the first dot. +.LP +Therefore it depends on the configuration of the resolver (usually in +.IR /etc/host.conf ) +how you can change it. Usually the hosts file is parsed before DNS or +NIS, so it is most common to change the FQDN in +.IR /etc/hosts . +.LP +If a machine has multiple network interfaces/addresses or is used in a +mobile environment, then it may either have multiple FQDNs/domain names +or none at all. Therefore avoid using +.BR "hostname \-\-fqdn" , +.B hostname \-\-domain +and +.BR "dnsdomainname" . +.B hostname \-\-ip-address +is subject to the same limitations so it should be avoided as well. + +.SH OPTIONS +.TP +.I "\-a, \-\-alias" +Display the alias name of the host (if used). This option is deprecated +and should not be used anymore. +.TP +.I "\-A, \-\-all-fqdns" +Displays all FQDNs of the machine. This option enumerates all configured +network addresses on all configured network interfaces, and translates +them to DNS domain names. Addresses that cannot be translated (i.e. because +they do not have an appropriate reverse IP entry) are skipped. Note that +different addresses may resolve to the same name, therefore the output may +contain duplicate entries. Do not make any assumptions about the order of the +output. +.TP +.I "\-b, \-\-boot" +Always set a hostname; this allows the file specified by \fI\-F\fR to be +non-existent or empty, in which case the default hostname \fIlocalhost\fR +will be used if none is yet set. +.TP +.I "\-d, \-\-domain" +Display the name of the DNS domain. Don't use the command +.B domainname +to get the DNS domain name because it will show the NIS domain name and +not the DNS domain name. Use +.B dnsdomainname +instead. See the warnings in section +.B THE FQDN +above, and avoid using this option. +.TP +.I "\-f, \-\-fqdn, \-\-long" +Display the FQDN (Fully Qualified Domain Name). A FQDN consists of a +short host name and the DNS domain name. Unless you are using bind or NIS +for host lookups you can change the FQDN and the DNS domain name (which is +part of the FQDN) in the \fI/etc/hosts\fR file. See the warnings in section +.B THE FQDN +above und use +.B hostname \-\-all-fqdns +instead wherever possible. +.TP +.I "\-F, \-\-file filename" +Read the host name from the specified file. Comments (lines starting with +a `#') are ignored. +.TP +.I "\-i, \-\-ip-address" +Display the network address(es) of the host name. Note that this works only +if the host name can be resolved. Avoid using this option; use +.B hostname \-\-all-ip-addresses +instead. +.TP +.I "\-I, \-\-all-ip-addresses" +Display all network addresses of the host. This option enumerates all +configured addresses on all network interfaces. The loopback interface and IPv6 +link-local addresses are omitted. Contrary to option \fI\-i\fR, this option +does not depend on name resolution. Do not make any assumptions about the +order of the output. +.TP +.I "\-s, \-\-short" +Display the short host name. This is the host name cut at the first dot. +.TP +.I "\-V, \-\-version" +Print version information on standard output and exit successfully. +.TP +.I "\-y, \-\-yp, \-\-nis" +Display the NIS domain name. If a parameter is given (or +.B \-\-file name +) then root can also set a new NIS domain. +.TP +.I "\-h, \-\-help" +Print a usage message and exit. +.SH NOTES +The address families +.B hostname +tries when looking up the FQDN, aliases and network addresses of the +host are determined by the configuration of your resolver. +For instance, on GNU Libc systems, the resolver can be instructed to +try IPv6 lookups first by using the +.B inet6 +option in +.BR /etc/resolv.conf . +.SH FILES +.B /etc/hostname +Historically this file was supposed to only contain the hostname and not the +full canonical FQDN. Nowadays most software is able to cope with a full FQDN +here. This file is read at boot time by the system initialization scripts to +set the hostname. +.LP +.B /etc/hosts +Usually, this is where one sets the domain name by aliasing the host name to +the FQDN. +.SH AUTHORS +Peter Tobias, +.br +Bernd Eckenfels, (NIS and manpage). +.br +Michael Meskes, +.br -- cgit v1.2.3