UnixConnection.receiveCredentials

gio.credentials.Credentials receiveCredentials(gio.cancellable.Cancellable cancellable = null)

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.

Parameters

cancellableA #GCancellable or null.

Returns

Received credentials on success (free with

gobject.object.ObjectWrap.unref), null if error is set.

Throws

ErrorWrap