Top | ![]() |
![]() |
![]() |
![]() |
gboolean | active | Read |
gboolean | encrypted-home | Read / Write |
char * | full-name | Read / Write |
char * | home-directory | Read / Write |
OobsUserHomeFlags | home-flags | Read / Write |
char * | home-phone | Read / Write |
char * | locale | Read / Write |
char * | name | Read / Write / Construct Only |
char * | other-data | Read / Write |
char * | password | Read / Write |
gboolean | password-disabled | Read / Write |
gboolean | password-empty | Read / Write |
char * | room-number | Read / Write |
char * | shell | Read / Write |
guint | uid | Read / Write |
char * | work-phone | Read / Write |
OobsUser *
oobs_user_new (const gchar *name
);
Returns a new user with the given login name.
const gchar *
oobs_user_get_login_name (OobsUser *user
);
Returns the login name of the user.
void oobs_user_set_password (OobsUser *user
,const gchar *password
);
Sets a new password for the user. This password will be interpreted as clean text and encrypted by the backends using PAM. Be careful deleting the passed string after using this function.
void oobs_user_set_uid (OobsUser *user
,uid_t uid
);
Sets a new UID for the user. files formerly owned by the user will not be chowned to the new UID, be careful using this function.
OobsGroup *
oobs_user_get_main_group (OobsUser *user
);
Returns the main group of this user.
void oobs_user_set_main_group (OobsUser *user
,OobsGroup *main_group
);
Sets the main group for the user.
const gchar *
oobs_user_get_home_directory (OobsUser *user
);
Returns the home directory path of the user.
void oobs_user_set_home_directory (OobsUser *user
,const gchar *home_directory
);
Sets a new home directory for the user. files stored in the previous home directory will not be moved, be careful using this function.
const gchar *
oobs_user_get_shell (OobsUser *user
);
Returns the default shell used by the user.
void oobs_user_set_shell (OobsUser *user
,const gchar *shell
);
Sets a new default shell for the user.
const gchar *
oobs_user_get_full_name (OobsUser *user
);
Returns the first GECOS field, usually the full name of the user.
const gchar *
oobs_user_get_full_name_fallback (OobsUser *user
);
Returns the first GECOS field, usually the full name of the user, or the login name if the field is empty.
void oobs_user_set_full_name (OobsUser *user
,const gchar *full_name
);
Sets a new full name for the user.
const gchar *
oobs_user_get_room_number (OobsUser *user
);
Returns the second GECOS field, usually the room number.
void oobs_user_set_room_number (OobsUser *user
,const gchar *room_number
);
Sets a new room number for the user.
const gchar *
oobs_user_get_work_phone_number (OobsUser *user
);
Returns the third GECOS field, usually the work phone number.
void oobs_user_set_work_phone_number (OobsUser *user
,const gchar *phone_number
);
Sets a new work phone number for the user.
const gchar *
oobs_user_get_home_phone_number (OobsUser *user
);
Returns the fourth GECOS field, usually the home phone number.
void oobs_user_set_home_phone_number (OobsUser *user
,const gchar *phone_number
);
Sets a new home phone number for the user.
const gchar *
oobs_user_get_other_data (OobsUser *user
);
Returns the fifth field of GECOS fields, reserved for additional data.
void oobs_user_set_other_data (OobsUser *user
,const gchar *data
);
Sets the data in the fifth GECOS field.
gboolean
oobs_user_get_password_empty (OobsUser *user
);
Returns whether the current password for user
is empty.
void oobs_user_set_password_empty (OobsUser *user
,gboolean empty
);
Forces an empty password for user
. (Setting the 'password' property
to the empty string is used to keep the current password.)
gboolean
oobs_user_get_password_disabled (OobsUser *user
);
Returns whether account for user
is currently disabled,
i.e. user is not allowed to log in.
void oobs_user_set_password_disabled (OobsUser *user
,gboolean disabled
);
Disable or enable account, allowing or preventing user
from logging in.
gboolean
oobs_user_get_encrypted_home (OobsUser *user
);
Returns whether home directory for user
is encrypted (e.g. using eCryptfs).
void oobs_user_set_encrypted_home (OobsUser *user
,gboolean encrypted_home
);
Set whether home directory for user
should be encrypted.
This function should only be used on new users before committing them,
and when the system supports it for the change to take effect.
void oobs_user_set_home_flags (OobsUser *user
,OobsUserHomeFlags home_flags
);
Set the flags affecting treatment of the user's home directory (remove home when deleting user, chown directory to user...).
void oobs_user_set_locale (OobsUser *user
,const gchar *locale
);
Sets the ISO 639 code representing the current locale for user
.
gboolean
oobs_user_get_active (OobsUser *user
);
Returns whether the use is currently logged in the system.
gboolean
oobs_user_is_root (OobsUser *user
);
Checks whether a group is the superuser, according to its name.
Determine special behaviors regarding the home directory. Flags only apply to some operations (commit, add or delete user), and have no effect in other cases.
When removing an OobsUser, also remove home dir; when committing, if home dir changes, remove old home dir. |
||
When creating or committing an OobsUser, recursively change the owner of home dir to user and main group. |
||
When committing an OobsUser and if home dir changes, copy old home to new path, overwriting files if needed (!). |
||
When creating an OobsUser and a path for home dir is given, or when committing a user and home dir changes, delete already present directory. |
“active”
property “active” gboolean
Whether the user is active.
Owner: OobsUser
Flags: Read
Default value: FALSE
“encrypted-home”
property “encrypted-home” gboolean
Whether user's home is encrypted.
Owner: OobsUser
Flags: Read / Write
Default value: FALSE
“full-name”
property “full-name” char *
User's full name.
Owner: OobsUser
Flags: Read / Write
Default value: NULL
“home-directory”
property “home-directory” char *
Home directory for the user.
Owner: OobsUser
Flags: Read / Write
Default value: NULL
“home-flags”
property“home-flags” OobsUserHomeFlags
Flags affecting home directory treatment.
Owner: OobsUser
Flags: Read / Write
“home-phone”
property “home-phone” char *
User's home phone.
Owner: OobsUser
Flags: Read / Write
Default value: NULL
“locale”
property “locale” char *
Preferred locale for the user.
Owner: OobsUser
Flags: Read / Write
Default value: NULL
“name”
property “name” char *
Login name for the user.
Owner: OobsUser
Flags: Read / Write / Construct Only
Default value: NULL
“other-data”
property “other-data” char *
Aditional data for the user.
Owner: OobsUser
Flags: Read / Write
Default value: NULL
“password”
property “password” char *
Password for the user.
Owner: OobsUser
Flags: Read / Write
Default value: NULL
“password-disabled”
property “password-disabled” gboolean
Whether user is forbidden logging in.
Owner: OobsUser
Flags: Read / Write
Default value: FALSE
“password-empty”
property “password-empty” gboolean
Whether user password is empty.
Owner: OobsUser
Flags: Read / Write
Default value: FALSE
“room-number”
property “room-number” char *
User's room number.
Owner: OobsUser
Flags: Read / Write
Default value: NULL
“shell”
property “shell” char *
Default shell for the user.
Owner: OobsUser
Flags: Read / Write
Default value: NULL
“uid”
property “uid” guint
UID for the user.
Owner: OobsUser
Flags: Read / Write
Allowed values: <= G_MAXINT
Default value: 2147483647