OobsGroup

OobsGroup — Object that represents an individual group.

Synopsis




            OobsGroup;
OobsGroup*  oobs_group_new                  (const gchar *name);
const gchar* oobs_group_get_name            (OobsGroup *group);
void        oobs_group_set_name             (OobsGroup *group,
                                             const gchar *name);
void        oobs_group_set_password         (OobsGroup *group,
                                             const gchar *password);
void        oobs_group_set_crypted_password (OobsGroup *group,
                                             const gchar *crypted_password);
gid_t       oobs_group_get_gid              (OobsGroup *group);
void        oobs_group_set_gid              (OobsGroup *group,
                                             gid_t gid);
GList*      oobs_group_get_users            (OobsGroup *group);
void        oobs_group_add_user             (OobsGroup *group,
                                             OobsUser *user);
void        oobs_group_remove_user          (OobsGroup *group,
                                             OobsUser *user);

Object Hierarchy


  GObject
   +----OobsGroup

Properties


  "crypted-password"     gchararray            : Read / Write
  "gid"                  gint                  : Read / Write
  "name"                 gchararray            : Read / Write
  "password"             gchararray            : Write

Description

Details

OobsGroup

typedef struct _OobsGroup OobsGroup;

oobs_group_new ()

OobsGroup*  oobs_group_new                  (const gchar *name);

Returns a newly allocated OobsGroup with the name specified by name.

name : group name.
Returns : A new OobsGroup.

oobs_group_get_name ()

const gchar* oobs_group_get_name            (OobsGroup *group);

Returns the name of the group represented by OobsGroup.

group : An OobsGroup.
Returns : A pointer to the group name as a string. This string must not be freed, modified or stored.

oobs_group_set_name ()

void        oobs_group_set_name             (OobsGroup *group,
                                             const gchar *name);

Sets the name of group to be name, overwriting the previous one.

group : An OobsGroup.
name : A new name for group.

oobs_group_set_password ()

void        oobs_group_set_password         (OobsGroup *group,
                                             const gchar *password);

Sets the group password for the group defined by OobsGroup, overwriting the previous one.

group : An OobsGroup.
password : A new password for group.

oobs_group_set_crypted_password ()

void        oobs_group_set_crypted_password (OobsGroup *group,
                                             const gchar *crypted_password);

Sets an already crypted password for the group defined by OobsGroup, overwriting the previous one.

group : An OobsGroup.
crypted_password : a new crypted password for group.

oobs_group_get_gid ()

gid_t       oobs_group_get_gid              (OobsGroup *group);

Returns the group ID (GID) associated to OobsGroup

group : An OobsGroup.
Returns : the group GID.

oobs_group_set_gid ()

void        oobs_group_set_gid              (OobsGroup *group,
                                             gid_t gid);

Sets the group ID (GID) of group to be gid.

group : An OobsGroup.
gid : A new GID for group.

oobs_group_get_users ()

GList*      oobs_group_get_users            (OobsGroup *group);

Returns a GList containing pointers to the OobsUser objects that represent the users represented by the group.

group : An OobsGroup.
Returns : a newly allocated GList, use g_list_free() to free it.

oobs_group_add_user ()

void        oobs_group_add_user             (OobsGroup *group,
                                             OobsUser *user);

Adds a new user to the group. If the user is already in the group, it does nothing.

group : An OobsGroup.
user : An OobsUser to add to the group.

oobs_group_remove_user ()

void        oobs_group_remove_user          (OobsGroup *group,
                                             OobsUser *user);

Removes an user from the group. If the user isn't a member of this group, this function does nothing.

group : An OobsGroup.
user : An OobsUser to remove from the group.

Property Details

The "crypted-password" property

  "crypted-password"     gchararray            : Read / Write

Crypted password for the group.

Default value: NULL

The "gid" property

  "gid"                  gint                  : Read / Write

Main group GID for the group.

Allowed values: [0,65534]

Default value: 65534

The "name" property

  "name"                 gchararray            : Read / Write

Name for the group.

Default value: NULL

The "password" property

  "password"             gchararray            : Write

Password for the group.

Default value: NULL