eu.aschuetz.nativeutils.api

Interface PosixNativeUtil

All Superinterfaces:

NativeUtil

All Known Subinterfaces:

FreeBSDNativeUtil, LinuxNativeUtil, NetBSDNativeUtil

public interface PosixNativeUtil
extends NativeUtil

Method Summary

Modifier and Type	Method and Description
String	__get_cpuid_count_model() Returns the CPU Model string.
int[]	__get_cpuid_count(int code, int subcode) queries the cpu for info.
NativeMemory	malloc(long size) Allocates a new pointer of the given size
NativeMemory	pointer(long ptr, long size, PointerHandler handler) Any calls to the resulting NativeMemory may cause the JVM to die due to a SEGFAULT is size is not specified correctly.
Stat	stat(String path) Gets information about a file for a given path.
void	symlink(String target, String linkpath) Creates a symlink pointing to target.
Utsname	uname() gets information about the unix system.
void	unlink(String path) Unlinks a link

Methods inherited from interface eu.aschuetz.nativeutils.api.NativeUtil

isFreeBSD, isJVM, isLinux, isNetBSD, isNoop, isPosix, isWindows

Method Detail

malloc

NativeMemory malloc(long size)
             throws OutOfMemoryError,
                    IllegalArgumentException

Allocates a new pointer of the given size

Throws:

OutOfMemoryError - if malloc returns NULL

IllegalArgumentException - if size is <= 0

pointer

NativeMemory pointer(long ptr,
                     long size,
                     PointerHandler handler)
              throws NullPointerException

Any calls to the resulting NativeMemory may cause the JVM to die due to a SEGFAULT is size is not specified correctly. the close() and sync() methods are noops.

Parameters:

ptr - pointer to the data

size - -1 if unknown.

Throws:

NullPointerException

stat

Stat stat(String path)
   throws FileNotFoundException,
          InvalidPathException,
          FileSystemLoopException,
          AccessDeniedException,
          UnknownNativeErrorException,
          IOException

Gets information about a file for a given path.

Parameters:

path - the path to the file

Returns:

never null

Throws:

IllegalArgumentException - If path is null

FileNotFoundException - If the file cannot be found

FileSystemLoopException - If too many sym links had to be followed to resolve the path

InvalidPathException - If the path is invalid (empty string, parent is not a directory etc)

AccessDeniedException - If the process lacks permission to resolve the path. (Parent directory does not have permission to list files for example)

IOException - If a unspecified IO error occures while reading the info from disc.

UnknownNativeErrorException - If any unexpected native error occures.

symlink

void symlink(String target,
             String linkpath)
      throws IOException,
             InvalidPathException,
             ReadOnlyFileSystemException,
             AccessDeniedException,
             FileAlreadyExistsException,
             UnknownNativeErrorException

Creates a symlink pointing to target. The symlink is placed at "linkpath".

Throws:

IOException - If an IOError occurs when creating the symlink

InvalidPathException - If any of the two paths is invalid

IllegalArgumentException - If target or linkpath is null

ReadOnlyFileSystemException - If the file system of linkpath is read only.

AccessDeniedException - If the process lacks permission to write to linkpath. (and/or do path resolving)

FileAlreadyExistsException - If the file at "linkpath" already exists

UnknownNativeErrorException - If any unexpected native error occures.

QuotaExceededException - If any os enforced quota limit is violated by creating the link.

unlink

void unlink(String path)
     throws IOException,
            AccessDeniedException,
            ResourceBusyException,
            FileIsDirectoryException,
            FileSystemLoopException,
            ReadOnlyFileSystemException

Unlinks a link

Parameters:

path - specifies the path to the link to unlink.

Throws:

IOException - If an IOError occurs when unlinking

AccessDeniedException - If EACCESS occurs

ResourceBusyException - if EBUSY occurs

FileIsDirectoryException - If path is a directory and not a symlink (Linux Only)

FileSystemLoopException - If the path contains a loop of symbolic links

ReadOnlyFileSystemException - If the file system is read only

__get_cpuid_count

int[] __get_cpuid_count(int code,
                        int subcode)

queries the cpu for info.
the returned int[] is null if the requested code/subcode is not supported by the cpu otherwise it has the length of 4 and contains the registers in this oder:
0 -> EAX
1 -> EBX
2 -> ECX
3 -> EDX
Note: on non X86/AMD64 this will always return null.

__get_cpuid_count_model

String __get_cpuid_count_model()

Returns the CPU Model string. Example for Intel CPU's would be "GenuineIntel" Note: on non X86/AMD64 this will always return null.

uname

Utsname uname()

gets information about the unix system.