[doc] Fix copy & paste mistake in gethostbyname_ex

[andresdelfino]

It seems part of gethostbyname_ex doc was copied from gethostbyaddr (which has an ip_address parameter).

Not sure if the proposed wording is correct, though, as it not clear to me what is going on with the hostname returned. Not sure if it's exactly the hostname passed as argument. Tried to read the C, but, yeah..

[miss-islington]

Thanks @andresdelfino for the PR, and @ambv for merging it 🌮🎉.. I'm working now to backport this PR to: 3.9, 3.10.
🐍🍒⛏🤖

[bedevere-bot]

GH-28742 is a backport of this pull request to the 3.10 branch.

[bedevere-bot]

GH-28743 is a backport of this pull request to the 3.9 branch.

[ambv]

Thanks for the fix, @andresdelfino. The returned hostname is the primary hostname of the given host. This means it's the same as the given hostname if there are no aliases:

>>> socket.gethostbyname_ex('lukasz.langa.pl')
('lukasz.langa.pl', [], ['66.111.4.53', '66.111.4.54'])

In case aliases exist and you passed one of them to the function, the returned primary hostname can be different:

>>> socket.gethostbyname_ex('www.facebook.com')
('star-mini.c10r.facebook.com', ['www.facebook.com'], ['157.240.20.35'])

[andresdelfino]

Thanks for the fix, @andresdelfino. The returned hostname is the primary hostname of the given host. This means it's the same as the given hostname if there are no aliases:

>>> socket.gethostbyname_ex('lukasz.langa.pl')
('lukasz.langa.pl', [], ['66.111.4.53', '66.111.4.54'])

In case aliases exist and you passed one of them to the function, the returned primary hostname can be different:

>>> socket.gethostbyname_ex('www.facebook.com')
('star-mini.c10r.facebook.com', ['www.facebook.com'], ['157.240.20.35'])

Thanks for the explanation!