Represents a user account on the system. Organize the user by login frequency and names. negative if @user1 is before @user2, zero if equal or positive if @user1 is after @user2 a user a user Retrieves the account type of @user. a #ActUserAccountType the user object to examine. Returns whether or not #ActUser is automatically logged in at boot time. %TRUE or %FALSE a #ActUser Retrieves the email address set by @user. a pointer to an array of characters which must not be modified or freed, or %NULL. the user object to examine. Retrieves the home directory for @user. a pointer to an array of characters which must not be modified or freed, or %NULL. the user object to examine. Returns the path to the account icon belonging to @user. a path to an icon a #ActUser Returns the value of #ActUser:language. the user’s language, or the empty string if they are using the system default language, or %NULL if there is no connection to the daemon a #ActUser Returns the value of #ActUser:languages. the user’s preferred languages, or the empty string if they are using the system default language, or %NULL if there is no connection to the daemon a #ActUser Retrieves the location set by @user. a pointer to an array of characters which must not be modified or freed, or %NULL. the user object to examine. Returns whether or not the #ActUser account is locked. %TRUE or %FALSE a #ActUser Returns the number of times @user has logged in. the login frequency a #ActUser Returns the login history for @user. a pointer to GVariant of type "a(xxa{sv})" which must not be modified or freed, or %NULL. a #ActUser Returns the last login time for @user. the login time a #ActUser Get the number of sessions for a user that are graphical and on the same seat as the session of the calling process. the number of sessions a user Get the number of sessions for a user on any seat of any type. See also act_user_get_num_sessions(). (Currently, this function is only implemented for systemd-logind. For ConsoleKit, it is equivalent to act_user_get_num_sessions.) the number of sessions a user Returns the user accounts service object path of @user, or %NULL if @user doesn't have an object path associated with it. the object path of the user a #ActUser Get the password expiration policy for a user. Note this function is synchronous and ignores errors. the user object to query. location to write time users password expires location to write time users password was last changed. location to write minimum number of days needed between password changes. location to write maximum number of days password can stay unchanged. location to write number of days to warn user password is about to expire. location to write number of days account will be locked after password expires. Retrieves the password hint set by @user. a pointer to an array of characters which must not be modified or freed, or %NULL. the user object to examine. Retrieves the password mode of @user. a #ActUserPasswordMode the user object to examine. Returns the id of the primary session of @user, or %NULL if @user has no primary session. The primary session will always be graphical and will be chosen from the sessions on the same seat as the seat of the session of the calling process. the id of the primary session of the user a #ActUser Retrieves the display name of @user. a pointer to an array of characters which must not be modified or freed, or %NULL. the user object to examine. Returns whether or not the #ActUser account has retained state in accountsservice. %TRUE or %FALSE a #ActUser Returns the path to the configured session for @user. a path to an icon a #ActUser Returns the type of the configured session for @user. a path to an icon a #ActUser Retrieves the shell assigned to @user. a pointer to an array of characters which must not be modified or freed, or %NULL. the user object to examine. Retrieves the ID of @user. a pointer to an array of characters which must not be modified or freed, or %NULL. the user object to examine. Retrieves the login name of @user. a pointer to an array of characters which must not be modified or freed, or %NULL. the user object to examine. Returns the path to the configured X session for @user. a path to an icon a #ActUser Determines whether or not the user object is loaded and ready to read from. #ActUserManager:is-loaded property must be %TRUE before calling act_user_manager_list_users() %TRUE or %FALSE a #ActUser Retrieves whether the user is a local account or not. %TRUE if the user is local the user object to examine. Returns whether or not #ActUser is currently graphically logged in on the same seat as the seat of the session of the calling process. %TRUE or %FALSE a #ActUser Returns whether or not #ActUser is currently logged in in any way whatsoever. See also act_user_is_logged_in(). (Currently, this function is only implemented for systemd-logind. For ConsoleKit, it is equivalent to act_user_is_logged_in.) %TRUE or %FALSE a #ActUser Retrieves whether the user is nonexistent or not. %TRUE if the user is nonexistent the user object to examine. Returns whether or not #ActUser represents a 'system account' like 'root' or 'nobody'. %TRUE or %FALSE a #ActUser Changes the account type of @user. Note this function is synchronous and ignores errors. the user object to alter. a #ActUserAccountType If enabled is set to %TRUE then this user will automatically be logged in at boot up time. Only one user can be configured to auto login at any given time, so subsequent calls to act_user_set_automatic_login() override previous calls. Note this function is synchronous and ignores errors. the user object to alter whether or not to autologin for user. Assigns a new email to @user. Note this function is synchronous and ignores errors. the user object to alter. an email address Assigns a new icon for @user. Note this function is synchronous and ignores errors. the user object to alter. path to an icon Assigns a new locale for @user, setting #ActUser:language. Note this function is synchronous and ignores errors. the user object to alter. a locale (for example, `en_US.utf8`), or the empty string to use the system default locale Assigns preferred languages for @user, setting #ActUser:languages, and overriding #ActUser:language with the first item in the list if there is one. Note this function is synchronous and ignores errors. the user object to alter. an array of locale (for example, `en_US.utf8`), or the empty string to use the system default locale Assigns a new location for @user. Note this function is synchronous and ignores errors. the user object to alter. a location Note this function is synchronous and ignores errors. the user object to alter. whether or not the account is locked Changes the password of @user to @password. @hint is displayed to the user if they forget the password. Note this function is synchronous and ignores errors. the user object to alter. a password a hint to help user recall password Set the password expiration policy for a user. Note this function is synchronous and ignores errors. the user object to query. location to write minimum number of days needed between password changes. location to write maximum number of days password can stay unchanged. location to write number of days to warn user password is about to expire. location to write number of days account will be locked after password expires. Changes the password of @user. If @password_mode is ACT_USER_PASSWORD_MODE_SET_AT_LOGIN then the user will be asked for a new password at the next login. If @password_mode is ACT_USER_PASSWORD_MODE_NONE then the user will not require a password to log in. Note this function is synchronous and ignores errors. the user object to alter. a #ActUserPasswordMode Assigns a new name for @user. Note this function is synchronous and ignores errors. the user object to alter. a new name Assigns a new session for @user. Note this function is synchronous and ignores errors. the user object to alter. a session (e.g. gnome) Assigns a type to the session for @user. Note this function is synchronous and ignores errors. the user object to alter. a type of session (e.g. "wayland" or "x11") Set the user expiration policy for a user. Note this function is synchronous and ignores errors. the user object to query. location to write users expires timestamp Assigns a new username for @user. Note this function is synchronous and ignores errors. the user object to alter. a new user name Assigns a new x session for @user. Note this function is synchronous and ignores errors. the user object to alter. an x session (e.g. gnome) The user’s locale, in the format `language[_territory][.codeset][@modifier]`, where `language` is an ISO 639 language code, `territory` is an ISO 3166 country code, and `codeset` is a character set or encoding identifier like `ISO-8859-1` or `UTF-8`; as specified by [`setlocale(3)`](man:setlocale(3)). The locale may be the empty string, which means the user is using the system default locale. The property may be %NULL if it wasn’t possible to load it from the daemon. Emitted when the user accounts changes in some way. Emitted when the list of sessions for this user changes. Type of user account Normal non-administrative user Administrative user A user manager object. Returns the user manager singleton instance. Calling this function will automatically being loading the user list if it isn't loaded already. The #ActUserManager:is-loaded property will be set to %TRUE when the users are finished loading and then act_user_manager_list_users() can be called. user manager object Activate the session for a given user. whether successfully activated the user manager the user to activate Caches a user account so it shows up via act_user_manager_list_users(). user object a #ActUserManager a user name Asynchronously caches a user account so it shows up via act_user_manager_list_users(). For more details, see act_user_manager_cache_user(), which is the synchronous version of this call. a #ActUserManager a unix user name optional #GCancellable object, %NULL to ignore a #GAsyncReadyCallback to call when the request is satisfied the data to pass to @callback Finishes an asynchronous user caching. See act_user_manager_cache_user_async(). user object a #ActUserManager a #GAsyncResult Check whether the user can switch to another session. whether we can switch to another session the user manager Creates a user account on the system. user object a #ActUserManager a unix user name a unix GECOS value a #ActUserAccountType Asynchronously creates a user account on the system. For more details, see act_user_manager_create_user(), which is the synchronous version of this call. a #ActUserManager a unix user name a unix GECOS value a #ActUserAccountType optional #GCancellable object, %NULL to ignore a #GAsyncReadyCallback to call when the request is satisfied the data to pass to @callback Finishes an asynchronous user creation. See act_user_manager_create_user_async(). user object a #ActUserManager a #GAsyncResult Deletes a user account on the system. %TRUE if the user account was successfully deleted a #ActUserManager an #ActUser object %TRUE to delete the users home directory Asynchronously deletes a user account from the system. For more details, see act_user_manager_delete_user(), which is the synchronous version of this call. a #ActUserManager a #ActUser object %TRUE to delete the users home directory optional #GCancellable object, %NULL to ignore a #GAsyncReadyCallback to call when the request is satisfied the data to pass to @callback Finishes an asynchronous user account deletion. See act_user_manager_delete_user_async(). %TRUE if the user account was successfully deleted a #ActUserManager a #GAsyncResult Retrieves a pointer to the #ActUser object for the login @username from @manager. Trying to use this object before its #ActUser:is-loaded property is %TRUE will result in undefined behavior. #ActUser object the manager to query. the login name of the user to get. Retrieves a pointer to the #ActUser object for the user with the given uid from @manager. Trying to use this object before its #ActUser:is-loaded property is %TRUE will result in undefined behavior. #ActUser object the manager to query. the uid of the user to get. Switch the display to the login manager. whether successful or not the user manager Get a list of system user accounts List of #ActUser objects a #ActUserManager Check whether or not the accounts service is running. whether or not accounts service is running a #ActUserManager Releases all metadata about a user account, including icon, language and session. If the user account is from a remote server and the user has never logged in before, then that account will no longer show up in ListCachedUsers() output. %TRUE if successful, otherwise %FALSE a #ActUserManager a user name Finishes an asynchronous user uncaching. See act_user_manager_uncache_user_async(). %TRUE if the user account was successfully uncached a #ActUserManager a #GAsyncResult Emitted when a user is added to the user manager. the #ActUser that was added One of the users has changed the #ActUser that changed One of the users has logged in or out. the #ActUser that changed login status Emitted when a user is removed from the user manager. the #ActUser that was removed Various error codes returned by the accounts service. Generic failure The user already exists The user does not exist Permission denied Operation not supported Mode for setting the user's password. Password set normally Password will be chosen at next login No password set An ActUser object represents a user account on the system. ActUserManager is a manager object that gives access to user creation, deletion, enumeration, etc. There is typically a singleton ActUserManager object, which can be obtained by act_user_manager_get_default().