org.apache.hadoop.fs.permission

Class FsPermission

java.lang.Object

org.apache.hadoop.fs.permission.FsPermission

All Implemented Interfaces:

Writable

@InterfaceAudience.Public
@InterfaceStability.Stable
public class FsPermission
extends Object
implements Writable

A class for file/directory permissions.

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_UMASK
static String	DEPRECATED_UMASK_LABEL umask property label deprecated key and code in getUMask method to accommodate it may be removed in version .23
static String	UMASK_LABEL

Constructor Summary

Constructors

Constructor and Description
FsPermission(org.apache.hadoop.fs.permission.FsAction u, org.apache.hadoop.fs.permission.FsAction g, org.apache.hadoop.fs.permission.FsAction o) Construct by the given FsAction.
FsPermission(org.apache.hadoop.fs.permission.FsAction u, org.apache.hadoop.fs.permission.FsAction g, org.apache.hadoop.fs.permission.FsAction o, boolean sb)
FsPermission(FsPermission other) Copy constructor
FsPermission(short mode) Construct by the given mode.
FsPermission(String mode) Construct by given mode, either in octal or symbolic format.

Method Summary

Methods

Modifier and Type	Method and Description
FsPermission	applyUMask(FsPermission umask) Apply a umask to this permission and return a new one
static FsPermission	createImmutable(short permission) Create an immutable FsPermission object.
boolean	equals(Object obj)
void	fromShort(short n)
static FsPermission	getDefault() Get the default permission for directory and symlink.
static FsPermission	getDirDefault() Get the default permission for directory.
static FsPermission	getFileDefault() Get the default permission for file.
org.apache.hadoop.fs.permission.FsAction	getGroupAction() Return group FsAction.
org.apache.hadoop.fs.permission.FsAction	getOtherAction() Return other FsAction.
boolean	getStickyBit()
static FsPermission	getUMask(Configuration conf) Get the user file creation mask (umask) UMASK_LABEL config param has umask value that is either symbolic or octal.
org.apache.hadoop.fs.permission.FsAction	getUserAction() Return user FsAction.
int	hashCode()
static FsPermission	read(DataInput in) Create and initialize a FsPermission from DataInput.
void	readFields(DataInput in) Deserialize the fields of this object from in.
static void	setUMask(Configuration conf, FsPermission umask) Set the user file creation mask (umask)
short	toShort() Encode the object to a short.
String	toString()
static FsPermission	valueOf(String unixSymbolicPermission) Create a FsPermission from a Unix symbolic permission string
void	write(DataOutput out) Serialize the fields of this object to out.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

DEPRECATED_UMASK_LABEL

public static final String DEPRECATED_UMASK_LABEL

umask property label deprecated key and code in getUMask method to accommodate it may be removed in version .23

See Also:

Constant Field Values

UMASK_LABEL

public static final String UMASK_LABEL

See Also:

Constant Field Values

DEFAULT_UMASK

public static final int DEFAULT_UMASK

See Also:

Constant Field Values

Constructor Detail

FsPermission

public FsPermission(org.apache.hadoop.fs.permission.FsAction u,
            org.apache.hadoop.fs.permission.FsAction g,
            org.apache.hadoop.fs.permission.FsAction o)

Construct by the given FsAction.

Parameters:

u - user action

g - group action

o - other action

FsPermission

public FsPermission(org.apache.hadoop.fs.permission.FsAction u,
            org.apache.hadoop.fs.permission.FsAction g,
            org.apache.hadoop.fs.permission.FsAction o,
            boolean sb)

FsPermission

public FsPermission(short mode)

Construct by the given mode.

Parameters:

mode -

See Also:

toShort()

FsPermission

public FsPermission(FsPermission other)

Copy constructor

Parameters:

other - other permission

FsPermission

public FsPermission(String mode)

Construct by given mode, either in octal or symbolic format.

Parameters:

mode - mode as a string, either in octal or symbolic format

Throws:

IllegalArgumentException - if mode is invalid

Method Detail

createImmutable

public static FsPermission createImmutable(short permission)

Create an immutable FsPermission object.

getUserAction

public org.apache.hadoop.fs.permission.FsAction getUserAction()

Return user FsAction.

getGroupAction

public org.apache.hadoop.fs.permission.FsAction getGroupAction()

Return group FsAction.

getOtherAction

public org.apache.hadoop.fs.permission.FsAction getOtherAction()

Return other FsAction.

fromShort

public void fromShort(short n)

write

public void write(DataOutput out)
           throws IOException

Serialize the fields of this object to out.

Specified by:

write in interface Writable

Parameters:

out - DataOuput to serialize this object into.

Throws:

IOException

readFields

public void readFields(DataInput in)
                throws IOException

Deserialize the fields of this object from in.

For efficiency, implementations should attempt to re-use storage in the existing object where possible.

Specified by:

readFields in interface Writable

Parameters:

in - DataInput to deseriablize this object from.

Throws:

IOException

read

public static FsPermission read(DataInput in)
                         throws IOException

Create and initialize a FsPermission from DataInput.

Throws:

IOException

toShort

public short toShort()

Encode the object to a short.

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

applyUMask

public FsPermission applyUMask(FsPermission umask)

Apply a umask to this permission and return a new one

getUMask

public static FsPermission getUMask(Configuration conf)

Get the user file creation mask (umask) UMASK_LABEL config param has umask value that is either symbolic or octal. Symbolic umask is applied relative to file mode creation mask; the permission op characters '+' clears the corresponding bit in the mask, '-' sets bits in the mask. Octal umask, the specified bits are set in the file mode creation mask. DEPRECATED_UMASK_LABEL config param has umask value set to decimal.

getStickyBit

public boolean getStickyBit()

setUMask

public static void setUMask(Configuration conf,
            FsPermission umask)

Set the user file creation mask (umask)

getDefault

public static FsPermission getDefault()

Get the default permission for directory and symlink. In previous versions, this default permission was also used to create files, so files created end up with ugo+x permission. See HADOOP-9155 for detail. Two new methods are added to solve this, please use getDirDefault() for directory, and use getFileDefault() for file. This method is kept for compatibility.

getDirDefault

public static FsPermission getDirDefault()

Get the default permission for directory.

getFileDefault

public static FsPermission getFileDefault()

Get the default permission for file.

valueOf

public static FsPermission valueOf(String unixSymbolicPermission)

Create a FsPermission from a Unix symbolic permission string

Parameters:

unixSymbolicPermission - e.g. "-rw-rw-rw-"