On 04/18/2017 12:54 PM, Marko Myllynen wrote: > Perhaps this is helpful. The HOSTALIASES section looks outdated given that > getaddrinfo(3) should be used but I'm not sure what should be done with it. > > The referenced mailaddr(7) might also benefit from a review but I'm out of > cycles for that currently. Thanks, Marko. Applied. Cheers, Michael > --- > man7/hostname.7 | 25 +++++++++++++++++++++++++ > 1 file changed, 25 insertions(+) > > diff --git a/man7/hostname.7 b/man7/hostname.7 > index bc181a9..2c960c6 100644 > --- a/man7/hostname.7 > +++ b/man7/hostname.7 > @@ -44,6 +44,21 @@ Hostnames are domains, where a domain is a hierarchical, dot-separated > list of subdomains; for example, the machine monet, in the "berkeley" > subdomain of the "edu" domain would be represented as "monet.berkeley.edu". > > +Each element of the hostname must be from 1 to 63 characters long and the > +entire hostname, including the dots, can be at most 253 characters long. > +Valid characters for hostnames are > +.BR ASCII (7) > +letters from > +.I a > +to > +.IR z , > +the digits from > +.I 0 > +to > +.IR 9 , > +and the hyphen (\-). > +A hostname may not start with a hyphen. > + > Hostnames are often used with network client and server programs, > which must generally translate the name to an address for use. > (This task is generally performed by either > @@ -83,10 +98,20 @@ The search path can be changed from the default > by a system-wide configuration file (see > .BR resolver (5)). > .SH SEE ALSO > +.BR getaddrinfo (3), > .BR gethostbyname (3), > .BR resolver (5), > .BR mailaddr (7), > .BR named (8) > + > +.UR http://www.ietf.org\:/rfc\:/rfc1123.txt > +IETF RFC\ 1123 > +.UE > + > +.UR http://www.ietf.org\:/rfc\:/rfc1178.txt > +IETF RFC\ 1178 > +.UE > + > .\" .SH HISTORY > .\" Hostname appeared in > .\" 4.2BSD. > > Thanks, > -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/ -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html