CfgTie::TieGroup -- an associative array of group names and ids to information

NAME

CfgTie::TieGroup -- an associative array of group names and ids to information

SYNOPSIS

Makes the groups database available as regular hash

        tie %group,'CfgTie::TieGroup'
        $group{'myfriends'}=['jonj', @{$group{'myfriends'}];

or

        tie %group,'CfgTie::TieGroup', 'mygroupfile'

DESCRIPTION

This is a straight forward hash tie that allows us to access the user group database sanely.

It cross ties with the user package and the mail packages

Ties

There are two ties available for programmers:

tie %group,'CfgTie::TieGroup'
$group{$name} will return a hash reference of the named group information.

tie %group_id,'CfgTie::Group_id'
$group_id{$id} will return a HASH reference for the specified group.

Structure of hash

Any given group entry has the following information assoicated with it:

name
id
members
A list reference to all of the users that are part of this group.

_members
A list reference to all of the users that are explicitly listed in the /etc/group file.

Plus an (probably) obsolete fields:

Password
This is the encrypted password, but will probably be obsolete.

Each of these entries can be modified (even deleted), and they will be reflected in the overall system. Additionally, the programmer can set any other associated key, but this information will only be available to a running Perl script.

Additional Routines

(tied %MyHash)-files()>
Returns a list of files employed.

&CfgTie::TieGroup'status()
&CfgTie::TieGroup_id'status()
Will return stat information on the group database.

Miscellaneous

$CfgTie::TieGroup_rec'groupmod contains the path to the program groupmod. This can be modified as required.

$CfgTie::TieGroup_rec'groupadd contains the path to the program groupadd. This can be modified as required.

$CfgTie::TieGroup_rec'groupdel contains the path to the program groupdel. This can be modified as required.

Files

/etc/passwd /etc/group /etc/gshadow /etc/shadow

See Also

the CfgTie::Cfgfile manpage, the CfgTie::TieAliases manpage, the CfgTie::TieGeneric manpage, the CfgTie::TieHost manpage, the CfgTie::TieMTab manpage, the CfgTie::TieNamed manpage, the CfgTie::TieNet manpage, the CfgTie::TiePh manpage, the CfgTie::TieProto manpage, the CfgTie::TieRCService manpage, the CfgTie::TieRsrc manpage, the CfgTie::TieServ manpage, the CfgTie::TieShadow manpage, the CfgTie::TieUser manpage

group(5), passwd(5), shadow(5), groupmod(8), groupadd(8), groupdel(8)

Caveats

The current version does cache some group information.

Author

Randall Maas (mailto:randym@acm.org, http://www.hamline.edu/~rcmaas/)

 CfgTie::TieGroup -- an associative array of group names and ids to information