Function

GLibunix_get_passwd_entry

Declaration [src]

passwd*
g_unix_get_passwd_entry (
  const gchar* user_name,
  GError** error
)

Description [src]

Get the passwd file entry for the given user_name using getpwnam_r(). This can fail if the given user_name doesn’t exist.

The returned struct passwd has been allocated using g_malloc() and should be freed using g_free(). The strings referenced by the returned struct are included in the same allocation, so are valid until the struct passwd is freed.

This function is safe to call from multiple threads concurrently.

You will need to include pwd.h to get the definition of struct passwd.

Available since:2.64

Parameters

user_name const gchar*
 

The username to get the passwd file entry for.

 The data is owned by the caller of the function.
 The string is a NUL terminated UTF-8 string.
error GError **
  The return location for a GError*, or NULL.

Return value

Returns: passwd*
 

Passwd entry, or NULL on error; free the returned value with g_free()

 The caller of the function takes ownership of the data, and is responsible for freeing it.
 The return value can be NULL.