user

Name

user -- Functions for initializing the library, looking up information, and making changes to the system information store.

Synopsis



lu_context_t* lu_start                      (const char *authname,
                                             lu_entity_type_t auth_type,
                                             const char *modules,
                                             const char *create_modules,
                                             lu_prompt_fn *prompter,
                                             gpointer callback_data,
                                             lu_error_t **error);
void        lu_end                          (lu_context_t *context);
void        lu_set_prompter                 (lu_context_t *context,
                                             lu_prompt_fn *prompter,
                                             gpointer callback_data);
void        lu_get_prompter                 (lu_context_t *context,
                                             lu_prompt_fn **prompter,
                                             gpointer *callback_data);
gboolean    lu_set_modules                  (lu_context_t *context,
                                             const char *list,
                                             lu_error_t **error);
const char* lu_get_modules                  (lu_context_t *context);
gboolean    lu_uses_elevated_privileges     (lu_context_t *context);
gboolean    lu_user_lookup_name             (lu_context_t *context,
                                             const char *name,
                                             struct lu_ent *ent,
                                             lu_error_t **error);
gboolean    lu_user_lookup_id               (lu_context_t *context,
                                             uid_t uid,
                                             struct lu_ent *ent,
                                             lu_error_t **error);
gboolean    lu_user_default                 (lu_context_t *ctx,
                                             const char *name,
                                             gboolean system,
                                             struct lu_ent *ent);
gboolean    lu_user_add                     (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);
gboolean    lu_user_modify                  (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);
gboolean    lu_user_delete                  (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);
gboolean    lu_user_setpass                 (lu_context_t *context,
                                             struct lu_ent *ent,
                                             const char *newpass,
                                             gboolean crypted,
                                             lu_error_t **error);
gboolean    lu_user_removepass              (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);
gboolean    lu_user_lock                    (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);
gboolean    lu_user_unlock                  (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);
gboolean    lu_user_islocked                (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);
GValueArray* lu_users_enumerate             (lu_context_t *context,
                                             const char *pattern,
                                             lu_error_t **error);
GValueArray* lu_users_enumerate_by_group    (lu_context_t *context,
                                             const char *group,
                                             lu_error_t **error);
GPtrArray*  lu_users_enumerate_full         (lu_context_t *context,
                                             const char *pattern,
                                             lu_error_t **error);
gboolean    lu_group_lookup_name            (lu_context_t *context,
                                             const char *name,
                                             struct lu_ent *ent,
                                             lu_error_t **error);
gboolean    lu_group_lookup_id              (lu_context_t *context,
                                             gid_t gid,
                                             struct lu_ent *ent,
                                             lu_error_t **error);
gboolean    lu_group_default                (lu_context_t *ctx,
                                             const char *name,
                                             gboolean system,
                                             struct lu_ent *ent);
gboolean    lu_group_add                    (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);
gboolean    lu_group_modify                 (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);
gboolean    lu_group_delete                 (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);
gboolean    lu_group_setpass                (lu_context_t *context,
                                             struct lu_ent *ent,
                                             const char *newpass,
                                             gboolean crypted,
                                             lu_error_t **error);
gboolean    lu_group_removepass             (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);
gboolean    lu_group_lock                   (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);
gboolean    lu_group_unlock                 (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);
gboolean    lu_group_islocked               (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);
GValueArray* lu_groups_enumerate            (lu_context_t *context,
                                             const char *pattern,
                                             lu_error_t **error);
GValueArray* lu_groups_enumerate_by_user    (lu_context_t *context,
                                             const char *user,
                                             lu_error_t **error);
GPtrArray*  lu_groups_enumerate_full        (lu_context_t *context,
                                             const char *pattern,
                                             lu_error_t **error);

Description

user.h contains declarations for functions which start up and shut down the libuser library, and for functions which perform lookup queries and modifications of the system information store.

Details

lu_start ()

lu_context_t* lu_start                      (const char *authname,
                                             lu_entity_type_t auth_type,
                                             const char *modules,
                                             const char *create_modules,
                                             lu_prompt_fn *prompter,
                                             gpointer callback_data,
                                             lu_error_t **error);

authname :

auth_type :

modules :

create_modules :

prompter :

callback_data :

error :

Returns :


lu_end ()

void        lu_end                          (lu_context_t *context);

context :


lu_set_prompter ()

void        lu_set_prompter                 (lu_context_t *context,
                                             lu_prompt_fn *prompter,
                                             gpointer callback_data);

context :

prompter :

callback_data :


lu_get_prompter ()

void        lu_get_prompter                 (lu_context_t *context,
                                             lu_prompt_fn **prompter,
                                             gpointer *callback_data);

context :

prompter :

callback_data :


lu_set_modules ()

gboolean    lu_set_modules                  (lu_context_t *context,
                                             const char *list,
                                             lu_error_t **error);

context :

list :

error :

Returns :


lu_get_modules ()

const char* lu_get_modules                  (lu_context_t *context);

context :

Returns :


lu_uses_elevated_privileges ()

gboolean    lu_uses_elevated_privileges     (lu_context_t *context);

context :

Returns :


lu_user_lookup_name ()

gboolean    lu_user_lookup_name             (lu_context_t *context,
                                             const char *name,
                                             struct lu_ent *ent,
                                             lu_error_t **error);

context :

name :

ent :

error :

Returns :


lu_user_lookup_id ()

gboolean    lu_user_lookup_id               (lu_context_t *context,
                                             uid_t uid,
                                             struct lu_ent *ent,
                                             lu_error_t **error);

context :

uid :

ent :

error :

Returns :


lu_user_default ()

gboolean    lu_user_default                 (lu_context_t *ctx,
                                             const char *name,
                                             gboolean system,
                                             struct lu_ent *ent);

ctx :

name :

system :

ent :

Returns :


lu_user_add ()

gboolean    lu_user_add                     (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);

context :

ent :

error :

Returns :


lu_user_modify ()

gboolean    lu_user_modify                  (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);

context :

ent :

error :

Returns :


lu_user_delete ()

gboolean    lu_user_delete                  (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);

context :

ent :

error :

Returns :


lu_user_setpass ()

gboolean    lu_user_setpass                 (lu_context_t *context,
                                             struct lu_ent *ent,
                                             const char *newpass,
                                             gboolean crypted,
                                             lu_error_t **error);

context :

ent :

newpass :

crypted :

error :

Returns :


lu_user_removepass ()

gboolean    lu_user_removepass              (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);

context :

ent :

error :

Returns :


lu_user_lock ()

gboolean    lu_user_lock                    (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);

context :

ent :

error :

Returns :


lu_user_unlock ()

gboolean    lu_user_unlock                  (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);

context :

ent :

error :

Returns :


lu_user_islocked ()

gboolean    lu_user_islocked                (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);

context :

ent :

error :

Returns :


lu_users_enumerate ()

GValueArray* lu_users_enumerate             (lu_context_t *context,
                                             const char *pattern,
                                             lu_error_t **error);

context :

pattern :

error :

Returns :


lu_users_enumerate_by_group ()

GValueArray* lu_users_enumerate_by_group    (lu_context_t *context,
                                             const char *group,
                                             lu_error_t **error);

context :

group :

error :

Returns :


lu_users_enumerate_full ()

GPtrArray*  lu_users_enumerate_full         (lu_context_t *context,
                                             const char *pattern,
                                             lu_error_t **error);

context :

pattern :

error :

Returns :


lu_group_lookup_name ()

gboolean    lu_group_lookup_name            (lu_context_t *context,
                                             const char *name,
                                             struct lu_ent *ent,
                                             lu_error_t **error);

context :

name :

ent :

error :

Returns :


lu_group_lookup_id ()

gboolean    lu_group_lookup_id              (lu_context_t *context,
                                             gid_t gid,
                                             struct lu_ent *ent,
                                             lu_error_t **error);

context :

gid :

ent :

error :

Returns :


lu_group_default ()

gboolean    lu_group_default                (lu_context_t *ctx,
                                             const char *name,
                                             gboolean system,
                                             struct lu_ent *ent);

ctx :

name :

system :

ent :

Returns :


lu_group_add ()

gboolean    lu_group_add                    (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);

context :

ent :

error :

Returns :


lu_group_modify ()

gboolean    lu_group_modify                 (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);

context :

ent :

error :

Returns :


lu_group_delete ()

gboolean    lu_group_delete                 (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);

context :

ent :

error :

Returns :


lu_group_setpass ()

gboolean    lu_group_setpass                (lu_context_t *context,
                                             struct lu_ent *ent,
                                             const char *newpass,
                                             gboolean crypted,
                                             lu_error_t **error);

context :

ent :

newpass :

crypted :

error :

Returns :


lu_group_removepass ()

gboolean    lu_group_removepass             (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);

context :

ent :

error :

Returns :


lu_group_lock ()

gboolean    lu_group_lock                   (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);

context :

ent :

error :

Returns :


lu_group_unlock ()

gboolean    lu_group_unlock                 (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);

context :

ent :

error :

Returns :


lu_group_islocked ()

gboolean    lu_group_islocked               (lu_context_t *context,
                                             struct lu_ent *ent,
                                             lu_error_t **error);

context :

ent :

error :

Returns :


lu_groups_enumerate ()

GValueArray* lu_groups_enumerate            (lu_context_t *context,
                                             const char *pattern,
                                             lu_error_t **error);

context :

pattern :

error :

Returns :


lu_groups_enumerate_by_user ()

GValueArray* lu_groups_enumerate_by_user    (lu_context_t *context,
                                             const char *user,
                                             lu_error_t **error);

context :

user :

error :

Returns :


lu_groups_enumerate_full ()

GPtrArray*  lu_groups_enumerate_full        (lu_context_t *context,
                                             const char *pattern,
                                             lu_error_t **error);

context :

pattern :

error :

Returns :