diff options
Diffstat (limited to 'dbus/dbus-connection.c')
| -rw-r--r-- | dbus/dbus-connection.c | 19 |
1 files changed, 14 insertions, 5 deletions
diff --git a/dbus/dbus-connection.c b/dbus/dbus-connection.c index e2debdd0..db625588 100644 --- a/dbus/dbus-connection.c +++ b/dbus/dbus-connection.c @@ -4752,11 +4752,20 @@ dbus_connection_get_socket(DBusConnection *connection, /** - * Gets the UNIX user ID of the connection if any. - * Returns #TRUE if the uid is filled in. - * Always returns #FALSE on non-UNIX platforms. - * Always returns #FALSE prior to authenticating the - * connection. + * Gets the UNIX user ID of the connection if known. Returns #TRUE if + * the uid is filled in. Always returns #FALSE on non-UNIX platforms. + * Always returns #FALSE prior to authenticating the connection. + * + * The UID is only read by servers from clients; clients can't usually + * get the UID of servers, because servers do not authenticate to + * clients. The returned UID is the UID the connection authenticated + * as. + * + * The message bus is a server and the apps connecting to the bus + * are clients. + * + * You can ask the bus to tell you the UID of another connection though + * if you like; this is done with dbus_bus_get_unix_user(). * * @param connection the connection * @param uid return location for the user ID |