Package org.apache.hadoop.security

Class JniBasedUnixGroupsMapping

java.lang.Object

org.apache.hadoop.security.JniBasedUnixGroupsMapping

All Implemented Interfaces:

GroupMappingServiceProvider

Direct Known Subclasses:

JniBasedUnixGroupsNetgroupMapping

@LimitedPrivate({"HDFS","MapReduce"})
@Evolving
public class JniBasedUnixGroupsMapping
extends Object
implements GroupMappingServiceProvider

A JNI-based implementation of GroupMappingServiceProvider that invokes libC calls to get the group memberships of a given user.

Field Summary

Fields inherited from interface org.apache.hadoop.security.GroupMappingServiceProvider

GROUP_MAPPING_CONFIG_PREFIX

Constructor Summary

Constructors

Constructor	Description
JniBasedUnixGroupsMapping()

Method Summary

Modifier and Type	Method	Description
void	cacheGroupsAdd(List<String> groups)	Caches the group user information
void	cacheGroupsRefresh()	Refresh the cache of groups and user mapping
List<String>	getGroups(String user)	Get all various group memberships of a given user.
Set<String>	getGroupsSet(String user)	Get all various group memberships of a given user.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

JniBasedUnixGroupsMapping

public JniBasedUnixGroupsMapping()

Method Details

getGroups

public List<String> getGroups(String user)
                       throws IOException

Description copied from interface: GroupMappingServiceProvider

Get all various group memberships of a given user. Returns EMPTY list in case of non-existing user

Specified by:

getGroups in interface GroupMappingServiceProvider

Parameters:

user - User's name

Returns:

group memberships of user

Throws:

IOException - raised on errors performing I/O.

getGroupsSet

public Set<String> getGroupsSet(String user)
                         throws IOException

Description copied from interface: GroupMappingServiceProvider

Get all various group memberships of a given user. Returns EMPTY set in case of non-existing user

Specified by:

getGroupsSet in interface GroupMappingServiceProvider

Parameters:

user - User's name

Returns:

set of group memberships of user

Throws:

IOException - raised on errors performing I/O.

cacheGroupsRefresh

public void cacheGroupsRefresh()
                        throws IOException

Description copied from interface: GroupMappingServiceProvider

Refresh the cache of groups and user mapping

Specified by:

cacheGroupsRefresh in interface GroupMappingServiceProvider

Throws:

IOException - raised on errors performing I/O.

cacheGroupsAdd

public void cacheGroupsAdd(List<String> groups)
                    throws IOException

Description copied from interface: GroupMappingServiceProvider

Caches the group user information

Specified by:

cacheGroupsAdd in interface GroupMappingServiceProvider

Parameters:

groups - list of groups to add to cache

Throws:

IOException - raised on errors performing I/O.