Interface LinuxLibc

All Superinterfaces:

CLibrary, LibC, LibCAPI, Library, Reboot, Resource

public interface LinuxLibc
extends LibC, CLibrary

Linux C Library. This class should be considered non-API as it may be removed if/when its code is incorporated into the JNA project.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	LinuxLibc.Exit_status	Part of utmpx structure
static class	LinuxLibc.LinuxUtmpx	Return type for getutxent()
static class	LinuxLibc.Rusage
static class	LinuxLibc.Ut_Tv	32-bit timeval required for utmpx structure

Nested classes/interfaces inherited from interface CLibrary

CLibrary.Addrinfo, CLibrary.BsdIp6stat, CLibrary.BsdIpstat, CLibrary.BsdTcpstat, CLibrary.BsdUdpstat, CLibrary.Sockaddr

Modifier and Type	Interface	Description
static class	CLibrary.Addrinfo
static class	CLibrary.BsdIp6stat
static class	CLibrary.BsdIpstat
static class	CLibrary.BsdTcpstat
static class	CLibrary.BsdUdpstat
static class	CLibrary.Sockaddr

Nested classes/interfaces inherited from interface LibC

LibC.Statvfs, LibC.Sysinfo

Nested classes/interfaces inherited from interface LibCAPI

LibCAPI.size_t, LibCAPI.ssize_t

Nested classes/interfaces inherited from interface Library

Library.Handler

Nested classes/interfaces inherited from interface Resource

Resource.Rlimit

Field Summary

Fields

Modifier and Type	Field	Description
static final LinuxLibc	INSTANCE
static final NativeLong	SYS_GETTID	SYS_gettid Defined in one of: arch/arm64/include/asm/unistd32.h, 224 arch/x86/include/uapi/asm/unistd_32.h, 224 arch/x86/include/uapi/asm/unistd_64.h, 186 include/uapi/asm-generic/unistd.h, 178

Fields inherited from interface CLibrary

AI_CANONNAME, LOGIN_PROCESS, RUSAGE_SELF, USER_PROCESS, UT_HOSTSIZE, UT_LINESIZE, UT_NAMESIZE

Modifier and Type	Field	Description
static final int	AI_CANONNAME
static final int	LOGIN_PROCESS
static final int	RUSAGE_SELF
static final int	USER_PROCESS
static final int	UT_HOSTSIZE
static final int	UT_LINESIZE
static final int	UT_NAMESIZE

Fields inherited from interface LibC

NAME

Fields inherited from interface LibCAPI

HOST_NAME_MAX

Fields inherited from interface 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_SYMBOL_PROVIDER, OPTION_TYPE_MAPPER

Fields inherited from interface Reboot

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

Fields inherited from interface 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

Method Summary

Modifier and Type	Method	Description
int	getrusage(int who, LinuxLibc.Rusage rusage)
int	gettid()	Returns the caller's thread ID (TID).
LinuxLibc.LinuxUtmpx	getutxent()	Reads a line from the current file position in the utmp file.
NativeLong	syscall(NativeLong number, Object... args)	syscall() performs the system call whose assembly language interface has the specified number with the specified arguments.

Methods inherited from interface CLibrary

endutxent, freeaddrinfo, gai_strerror, getaddrinfo, getpid, open, pread, setutxent, sysctl, sysctlbyname, sysctlnametomib

Modifier and Type	Method	Description
void	endutxent()	Closes the utmp file.
void	freeaddrinfo(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, 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	open(String absolutePath, int i)
LibCAPI.ssize_t	pread(int fildes, Pointer buf, LibCAPI.size_t nbyte, NativeLong offset)
void	setutxent()	Rewinds the file pointer to the beginning of the utmp file.
int	sysctl(int[] name, int namelen, Pointer oldp, LibCAPI.size_t.ByReference oldlenp, Pointer newp, LibCAPI.size_t newlen)	The sysctl() function retrieves system information and allows processes with appropriate privileges to set system information.
int	sysctlbyname(String name, Pointer oldp, LibCAPI.size_t.ByReference oldlenp, Pointer newp, LibCAPI.size_t newlen)	The sysctlbyname() function accepts an ASCII representation of the name and internally looks up the integer name vector.
int	sysctlnametomib(String name, Pointer mibp, LibCAPI.size_t.ByReference sizep)	The sysctlnametomib() function accepts an ASCII representation of the name, looks up the integer name vector, and returns the numeric representation in the mib array pointed to by mibp.

Methods inherited from interface LibC

statvfs, sysinfo

Methods inherited from interface LibCAPI

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

Methods inherited from interface Reboot

reboot

Methods inherited from interface Resource

getrlimit, setrlimit

Field Details

INSTANCE

static final LinuxLibc INSTANCE

SYS_GETTID

static final NativeLong SYS_GETTID

SYS_gettid Defined in one of: arch/arm64/include/asm/unistd32.h, 224 arch/x86/include/uapi/asm/unistd_32.h, 224 arch/x86/include/uapi/asm/unistd_64.h, 186 include/uapi/asm-generic/unistd.h, 178

Method Details

getutxent

LinuxLibc.LinuxUtmpx getutxent()

Reads a line from the current file position in the utmp file. It returns a pointer to a structure containing the fields of the line.

Not thread safe

Returns:

a LinuxLibc.LinuxUtmpx on success, and NULL on failure (which includes the "record not found" case)

gettid

int gettid()

Returns the caller's thread ID (TID). In a single-threaded process, the thread ID is equal to the process ID. In a multithreaded process, all threads have the same PID, but each one has a unique TID.

Returns:

the thread ID of the calling thread.

syscall

NativeLong syscall(NativeLong number,
 Object... args)

syscall() performs the system call whose assembly language interface has the specified number with the specified arguments.

Parameters:

number - sys call number

args - sys call arguments

Returns:

The return value is defined by the system call being invoked. In general, a 0 return value indicates success. A -1 return value indicates an error, and an error code is stored in errno.

getrusage

int getrusage(int who,
 LinuxLibc.Rusage rusage)