org.aoju.bus.health.common.unix

Interface CLibrary

All Superinterfaces:

com.sun.jna.platform.unix.LibCAPI, com.sun.jna.Library, com.sun.jna.platform.unix.Reboot, com.sun.jna.platform.unix.Resource

All Known Subinterfaces:

FreeBsdLibc, LinuxLibc, SolarisLibc, SystemB

public interface CLibrary
extends com.sun.jna.platform.unix.LibCAPI, com.sun.jna.Library

C library with code common to all *nix-based operating systems. This class should be considered non-API as it may be removed if/when its code is incorporated into the JNA project.

Since:

JDK 1.8+

Version:

5.5.0

Author:

Kimi Liu

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	CLibrary.Addrinfo
static class	CLibrary.Sockaddr
static class	CLibrary.Timeval Return type for BSD sysctl kern.boottime

Nested classes/interfaces inherited from interface com.sun.jna.platform.unix.Resource

com.sun.jna.platform.unix.Resource.Rlimit

Nested classes/interfaces inherited from interface com.sun.jna.Library

com.sun.jna.Library.Handler

Field Summary

Fields

Modifier and Type	Field and Description
static int	AI_CANONNAME Constant AI_CANONNAME=2

Fields inherited from interface com.sun.jna.platform.unix.LibCAPI

HOST_NAME_MAX

Fields inherited from interface com.sun.jna.platform.unix.Reboot

RB_AUTOBOOT, RB_DISABLE_CAD, RB_ENABLE_CAD, RB_HALT_SYSTEM, RB_KEXEC, RB_POWER_OFF, RB_SW_SUSPEND

Fields inherited from interface com.sun.jna.platform.unix.Resource

RLIMIT_AS, RLIMIT_CORE, RLIMIT_CPU, RLIMIT_DATA, RLIMIT_FSIZE, RLIMIT_LOCKS, RLIMIT_MEMLOCK, RLIMIT_MSGQUEUE, RLIMIT_NICE, RLIMIT_NLIMITS, RLIMIT_NOFILE, RLIMIT_NPROC, RLIMIT_RSS, RLIMIT_RTPRIO, RLIMIT_RTTIME, RLIMIT_SIGPENDING, RLIMIT_STACK

Fields inherited from interface com.sun.jna.Library

OPTION_ALLOW_OBJECTS, OPTION_CALLING_CONVENTION, OPTION_CLASSLOADER, OPTION_FUNCTION_MAPPER, OPTION_INVOCATION_MAPPER, OPTION_OPEN_FLAGS, OPTION_STRING_ENCODING, OPTION_STRUCTURE_ALIGNMENT, OPTION_TYPE_MAPPER

Method Summary

Modifier and Type	Method and Description
void	freeaddrinfo(com.sun.jna.Pointer res) Frees the memory that was allocated for the dynamically allocated linked list res.
String	gai_strerror(int e) Translates getaddrinfo error codes to a human readable string, suitable for error reporting.
int	getaddrinfo(String node, String service, CLibrary.Addrinfo hints, com.sun.jna.ptr.PointerByReference res) Given node and service, which identify an Internet host and a service, getaddrinfo() returns one or more addrinfo structures, each of which contains an Internet address that can be specified in a call to bind(2) or connect(2).
int	getpid() Returns the process ID of the calling process.
int	readlink(String path, com.sun.jna.Pointer buf, int bufsize) Places the contents of the symbolic link path in the buffer buf, which has size bufsiz.

Methods inherited from interface com.sun.jna.platform.unix.LibCAPI

getdomainname, getegid, getenv, geteuid, getgid, gethostname, getloadavg, getuid, setdomainname, setegid, setenv, seteuid, setgid, sethostname, setuid, unsetenv

Methods inherited from interface com.sun.jna.platform.unix.Reboot

reboot

Methods inherited from interface com.sun.jna.platform.unix.Resource

getrlimit, setrlimit

Field Detail

AI_CANONNAME

static final int AI_CANONNAME

Constant AI_CANONNAME=2

See Also:

Constant Field Values

Method Detail

getpid

int getpid()

Returns the process ID of the calling process. The ID is guaranteed to be unique and is useful for constructing temporary file names.

Returns:

the process ID of the calling process.

getaddrinfo

int getaddrinfo(String node,
                String service,
                CLibrary.Addrinfo hints,
                com.sun.jna.ptr.PointerByReference res)

Given node and service, which identify an Internet host and a service, getaddrinfo() returns one or more addrinfo structures, each of which contains an Internet address that can be specified in a call to bind(2) or connect(2).

Parameters:

node - a numerical network address or a network hostname, whose network addresses are looked up and resolved.

service - sets the port in each returned address structure.

hints - specifies criteria for selecting the socket address structures returned in the list pointed to by res.

res - returned address structure

Returns:

0 on success; sets errno on failure

freeaddrinfo

void freeaddrinfo(com.sun.jna.Pointer res)

Frees the memory that was allocated for the dynamically allocated linked list res.

Parameters:

res - Pointer to linked list returned by getaddrinfo

gai_strerror

String gai_strerror(int e)

Translates getaddrinfo error codes to a human readable string, suitable for error reporting.

Parameters:

e - Error code from getaddrinfo

Returns:

A human-readable version of the error code

readlink

int readlink(String path,
             com.sun.jna.Pointer buf,
             int bufsize)

Places the contents of the symbolic link path in the buffer buf, which has size bufsiz.

Parameters:

path - A symbolic link

buf - Holds actual path to location pointed to by symlink

bufsize - size of data in buffer

Returns:

readlink() places the contents of the symbolic link path in the buffer buf, which has size bufsiz. readlink() does not append a null byte to buf. It will truncate the contents (to a length of bufsiz characters), in case the buffer is too small to hold all of the contents.