org.apache.sshd.common.util.io

Class ModifiableFileWatcher

java.lang.Object

org.apache.sshd.common.util.logging.AbstractLoggingBean

org.apache.sshd.common.util.io.ModifiableFileWatcher

Direct Known Subclasses:

AuthorizedKeysAuthenticator, ClientIdentityFileWatcher, ConfigFileHostEntryResolver, KnownHostsServerKeyVerifier

public class ModifiableFileWatcher
extends AbstractLoggingBean

Watches over changes for a file and re-loads them if file has changed - including if file is deleted or (re-)created

Author:

Apache MINA SSHD Project

Field Summary

Fields

Modifier and Type	Field and Description
protected LinkOption[]	options
static Set<PosixFilePermission>	STRICTLY_PROHIBITED_FILE_PERMISSION The Set of PosixFilePermission not allowed if strict permissions are enforced on key files

Fields inherited from class org.apache.sshd.common.util.logging.AbstractLoggingBean

log

Constructor Summary

Constructors

Constructor and Description
ModifiableFileWatcher(File file)
ModifiableFileWatcher(Path file)
ModifiableFileWatcher(Path file, LinkOption... options)

Method Summary

Modifier and Type	Method and Description
boolean	checkReloadRequired()
boolean	exists()
Path	getPath()
FileTime	lastModified()
void	resetReloadAttributes() Resets the state attributes used to detect changes to the initial construction values - i.e., file assumed not to exist and no known size of modify time
long	size()
String	toString()
void	updateReloadAttributes() May be called to refresh the state attributes used to detect changes e.g., file existence, size and last-modified time once re-loading is successfully completed.
static Pair<String,Object>	validateStrictConfigFilePermissions(Path path, LinkOption... options) Checks if a path has strict permissions (For Unix) The path may not have group or others write permissions The path must be owned by current user.

Methods inherited from class org.apache.sshd.common.util.logging.AbstractLoggingBean

getSimplifiedLogger

Methods inherited from class java.lang.Object

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

Field Detail

STRICTLY_PROHIBITED_FILE_PERMISSION

public static final Set<PosixFilePermission> STRICTLY_PROHIBITED_FILE_PERMISSION

The Set of PosixFilePermission not allowed if strict permissions are enforced on key files

options

protected final LinkOption[] options

Constructor Detail

ModifiableFileWatcher

public ModifiableFileWatcher(File file)

ModifiableFileWatcher

public ModifiableFileWatcher(Path file)

ModifiableFileWatcher

public ModifiableFileWatcher(Path file,
                             LinkOption... options)

Method Detail

getPath

public final Path getPath()

Returns:

The watched Path

exists

public final boolean exists()
                     throws IOException

Throws:

IOException

size

public final long size()
                throws IOException

Throws:

IOException

lastModified

public final FileTime lastModified()
                            throws IOException

Throws:

IOException

checkReloadRequired

public boolean checkReloadRequired()
                            throws IOException

Returns:

true if the watched file has probably been changed

Throws:

IOException - If failed to query file data

resetReloadAttributes

public void resetReloadAttributes()

Resets the state attributes used to detect changes to the initial construction values - i.e., file assumed not to exist and no known size of modify time

updateReloadAttributes

public void updateReloadAttributes()
                            throws IOException

May be called to refresh the state attributes used to detect changes e.g., file existence, size and last-modified time once re-loading is successfully completed. If the file does not exist then the attributes are reset to an "unknown" state.

Throws:

IOException - If failed to access the file (if exists)

See Also:

resetReloadAttributes()

toString

public String toString()

Overrides:

toString in class Object

validateStrictConfigFilePermissions

public static Pair<String,Object> validateStrictConfigFilePermissions(Path path,
                                                                      LinkOption... options)
                                                               throws IOException

Checks if a path has strict permissions

• (For Unix) The path may not have group or others write permissions

• The path must be owned by current user.

• (For Unix) The path may be owned by root.

Parameters:

path - The Path to be checked - ignored if null or does not exist

options - The LinkOptions to use to query the file's permissions

Returns:

The violated permission as Pair where Object.getClass() is a loggable message and Pair.getSecond() is the offending object - e.g., PosixFilePermission or String for owner. Return value is null if no violations detected

Throws:

IOException - If failed to retrieve the permissions

See Also:

STRICTLY_PROHIBITED_FILE_PERMISSION