Method

GioUnixConnectionsend_credentials

Declaration

gboolean
g_unix_connection_send_credentials (
  GUnixConnection* connection,
  GCancellable* cancellable,
  GError** error
)

Description

Passes the credentials of the current user the receiving side of the connection. The receiving end has to call g_unix_connection_receive_credentials() (or similar) to accept the credentials.

As well as sending the credentials this also writes a single NUL byte to 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 g_socket_get_credentials() function.

Available since:

2.26

Parameters

`cancellable`	`GCancellable`
	A `GCancellable` or `NULL`.
	The argument can be `NULL`.
	The data is owned by the caller of the function.
`error`	`GError **`
	The return location for a `GError*`, or `NULL`.

Return value

Returns:	`gboolean`
	`TRUE` on success, `FALSE` if `error` is set.