Package org.apache.hadoop.fs

Class HardLink

java.lang.Object

org.apache.hadoop.fs.HardLink

Direct Known Subclasses:

FileUtil.HardLink

public class HardLink
extends java.lang.Object

Class for creating hardlinks. Supports Unix/Linux, Windows via winutils , and Mac OS X. The HardLink class was formerly a static inner class of FSUtil, and the methods provided were blatantly non-thread-safe. To enable volume-parallel Update snapshots, we now provide static threadsafe methods that allocate new buffer string arrays upon each call. We also provide an API to hardlink all files in a directory with a single command, which is up to 128 times more efficient - and minimizes the impact of the extra buffer creations.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	HardLink.LinkStats	HardLink statistics counters and methods.

Field Summary

Fields

Modifier and Type	Field	Description
HardLink.LinkStats	linkStats

Constructor Summary

Constructors

Constructor	Description
HardLink()

Method Summary

Modifier and Type	Method	Description
static void	createHardLink(java.io.File file, java.io.File linkName)	Creates a hardlink.
static void	createHardLinkMult(java.io.File parentDir, java.lang.String[] fileBaseNames, java.io.File linkDir)	Creates hardlinks from multiple existing files within one parent directory, into one target directory.
static int	getLinkCount(java.io.File fileName)	Retrieves the number of links to the specified file.

Methods inherited from class java.lang.Object

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

Field Detail

linkStats

public final HardLink.LinkStats linkStats

Constructor Detail

HardLink

public HardLink()

Method Detail

createHardLink

public static void createHardLink(java.io.File file,
                                  java.io.File linkName)
                           throws java.io.IOException

Creates a hardlink.

Parameters:

file - - existing source file

linkName - - desired target link file

Throws:

java.io.IOException - raised on errors performing I/O.

createHardLinkMult

public static void createHardLinkMult(java.io.File parentDir,
                                      java.lang.String[] fileBaseNames,
                                      java.io.File linkDir)
                               throws java.io.IOException

Creates hardlinks from multiple existing files within one parent directory, into one target directory.

Parameters:

parentDir - - directory containing source files

fileBaseNames - - list of path-less file names, as returned by parentDir.list()

linkDir - - where the hardlinks should be put. It must already exist.

Throws:

java.io.IOException - raised on errors performing I/O.

getLinkCount

public static int getLinkCount(java.io.File fileName)
                        throws java.io.IOException

Retrieves the number of links to the specified file.

Parameters:

fileName - file name.

Returns:

link count.

Throws:

java.io.IOException - raised on errors performing I/O.