UnixConnection.receiveCredentials

Receives credentials from the sending end of the connection. The sending end has to call gio.unix_connection.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 #GUnixCredentialsMessage type and gio.socket.Socket.getCredentials function.

class UnixConnection
receiveCredentials

Parameters

cancellable gio.cancellable.Cancellable

A #GCancellable or null.

Return Value

Type: gio.credentials.Credentials

Received credentials on success (free with gobject.object.ObjectG.unref), null if error is set.