event/ServerSocket, doc, ...: refer to AF_LOCAL as "local socket"

.. and not "UNIX domain socket.  Be consistent about the naming.
This commit is contained in:
Max Kellermann
2019-03-20 12:57:26 +01:00
parent 7de8fd04a4
commit 4f408bd952
8 changed files with 12 additions and 12 deletions

View File

@@ -23,14 +23,14 @@
class ServerSocket;
/**
* Sets the address or unix socket of a ServerSocket instance
* Sets the address or local socket of a ServerSocket instance
* There are three possible ways
* 1) Set address to a valid ip address and specify port.
* server_socket will listen on this address/port tuple.
* 2) Set address to null and specify port.
* server_socket will listen on ANY address on that port.
* 3) Set address to a path of a unix socket. port is ignored.
* server_socket will listen on this unix socket.
* 3) Set address to a path of a local socket. port is ignored.
* server_socket will listen on this local socket.
*
* Throws #std::runtime_error on error.
*

View File

@@ -392,7 +392,7 @@ ServerSocket::AddPath(AllocatedPath &&path)
#else /* !HAVE_UN */
(void)path;
throw std::runtime_error("UNIX domain socket support is disabled");
throw std::runtime_error("Local socket support is disabled");
#endif /* !HAVE_UN */
}

View File

@@ -90,7 +90,7 @@ public:
void AddHost(const char *hostname, unsigned port);
/**
* Add a listener on a Unix domain socket.
* Add a listener on a local socket.
*
* Throws #std::runtime_error on error.
*

View File

@@ -35,7 +35,7 @@ socket_bind_listen(int domain, int type, int protocol,
throw MakeSocketError("Failed to create socket");
#ifdef HAVE_UN
if (domain == AF_UNIX) {
if (domain == AF_LOCAL) {
/* Prevent access until right permissions are set */
fchmod(fd.Get(), 0);
}

View File

@@ -32,7 +32,7 @@ class SocketAddress;
/**
* Creates a socket listening on the specified address. This is a
* shortcut for socket(), bind() and listen().
* When a unix socket is created (domain == AF_UNIX), its
* When a local socket is created (domain == AF_LOCAL), its
* permissions will be stripped down to prevent unauthorized
* access. The caller is responsible to apply proper permissions
* at a later point.

View File

@@ -106,7 +106,7 @@ ToString(SocketAddress address) noexcept
{
#ifdef HAVE_UN
if (address.GetFamily() == AF_LOCAL)
/* return path of UNIX domain sockets */
/* return path of local socket */
return LocalAddressToString(*(const sockaddr_un *)address.GetAddress(),
address.GetSize());
#endif