UnixConnection.receiveCredentials

Receives credentials from the sending end of the connection. The sending end has to call UnixConnection.sendCredentials (or similar) for this to work.

As well as reading the credentials this also reads (and discards) a single byte from the stream, as this is required for credentials passing to work on some implementations.

This method can be expected to be available on the following platforms:

- Linux since GLib 2.26 - FreeBSD since GLib 2.26 - GNU/kFreeBSD since GLib 2.36 - Solaris, Illumos and OpenSolaris since GLib 2.40 - GNU/Hurd since GLib 2.40

Other ways to exchange credentials with a foreign peer includes the gio.UnixCredentialsMessage type and Socket.getCredentials function.

class UnixConnection
receiveCredentials

Parameters

cancellable Cancellable

A gio.Cancellable or NULL.

Return Value

Received credentials on success (free with g_object_unref()), NULL if error is set.

Throws

GException on failure.

Meta

Since

2.26