get_credentials


Description:

[ Version ( since = "2.26" ) ]
public Credentials get_credentials () throws Error

Returns the credentials of the foreign process connected to this socket, if any (e.

g. it is only supported for g_socket_family_unix sockets).

If this operation isn't supported on the OS, the method fails with the g_io_error_not_supported error. On Linux this is implemented by reading the so_peercred option on the underlying socket.

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

  • Linux since GLib 2.26
  • OpenBSD since GLib 2.30
  • Solaris, Illumos and OpenSolaris since GLib 2.40
  • NetBSD since GLib 2.42
  • macOS, tvOS, iOS since GLib 2.66

Other ways to obtain credentials from a foreign peer includes the GUnixCredentialsMessage type and g_unix_connection_send_credentials / g_unix_connection_receive_credentials functions.

Parameters:

this

a Socket.

Returns:

null if throws is set, otherwise a Credentials object that must be freed with unref.




2022 vala-language.org