GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  NET::NIS::LISTGROUP (3)

.ds Aq ’

NAME

Listgroup.pm - Lists hosts/users in a netgroup group.

CONTENTS

SYNOPSIS



    use Listgroup;

    $array_ref_groups = listgroup();
    $array_ref_groups = listgroups();

    $array_ref_users_or_groups = listgroup({groupname});

    $array_ref_users_or_groups = listgroup_user({groupname1},
            [ [-]{groupname2}, [-]{gropuname3} ]);

    $array_ref_users_or_groups = listgroup_host({groupname1},
            [ [-]{groupname2}, [-]{gropuname3} ]);



DESCRIPTION

A library used to get groups or members of a netgroup NIS map. <B>B>listgroup()<B>B> without any parameters or <B>B>listgroups()<B>B> lists all the available netgroup groups.

With groupname parameters <B>listgroup, listgroup_user, listgroup_hostB> will recusively list the members of the named groups. If the groupname is preceded with a <B>-B> members of that group will be excluded from the returned list. Each member in a group is a triplet of (host,user,domain). The host portion or user portion of the members is returned by <B>B>listgroup_host()<B>B> and <B>B>listgroup()<B>B>, the user portion of the members is returned by <B>B>listgroup_user()<B>B>.

REQUIRES

Net::NIS

SEE ALSO

netgroup(4), listgroup(1), Net::NIS(3)

AUTHOR

Original unknown

Major rewrite by Marc Prewitt <mprewitt@chelsea.net>

Copyright (C) 2003 Chelsea Networks, under the GNU GPL. listgroup comes with ABSOLUTELY NO WARRANTY. This is free software, and you are welcome to redistribute it under certain conditions; see the COPYING file for details.

listgroup is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

listgroup is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

PUBLIC METHODS

    listgroups



    $array_ref_groups = listgroups();



Returns a reference to an array of groups from the netgroup nis map.

    listgroup_host, listgroup



    $array_ref_users_or_groups = listgroup({groupname1},
            [ [-]{groupname2}, [-]{gropuname3} ]);

    $array_ref_users_or_groups = listgroup_host({groupname1},
            [ [-]{groupname2}, [-]{gropuname3} ]);



Returns a reference to an array of the host portion of the members of the provided groups. Members of groupnames preceded by a <B>-B> will be excluded from the returned list.

Groups are processed in the order they appear in the parameter list.

If the NIS map ’netgroup’ does not exist or another fatal NIS error occurs, die will be called. Wrap this call in an eval if you want to catch that type of error.

    listgroup_user



    $array_ref_users_or_groups = listgroup_user({groupname1},
            [ [-]{groupname2}, [-]{gropuname3} ]);



Returns a reference to an array of the user portion of the members of the provided groups. Members of groupnames preceded by a <B>-B> will be excluded from the returned list.

Groups are processed in the order they appear in the parameter list.

If the NIS map ’netgroup’ does not exist or another fatal NIS error occurs, die will be called. Wrap this call in an eval if you want to catch that type of error.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 NET::NIS::LISTGROUP (3) 2003-01-21

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.