com.sun.squawk.platform.posix.natives
Interface Socket

All Superinterfaces:

Library

All Known Implementing Classes:

SocketImpl, SocketImpl, SocketImpl, SocketImpl, SocketImpl

public interface Socket
extends Library

java wrapper around BSD sockets

Nested Class Summary

static class

Socket.sockaddr_in C STRUCTURE sockaddr_in / struct sockaddr_in { u_char sin_len; 1 u_char sin_family; 1 u_short sin_port; 2 struct in_addr sin_addr; 4 char sin_zero[8]; 8 }; struct sockaddr { __uint8_t sa_len; /* total length sa_family_t sa_family; /* [XSI] address family char sa_data[14]; /* [XSI] addr value (actually larger) };

Field Summary

static int	AF_INET
static int	INADDR_ANY
static int	INET_ADDRSTRLEN
static Socket	INSTANCE
static int	IPPROTO_TCP
static int	SO_ACCEPTCONN
static int	SO_BROADCAST
static int	SO_DEBUG
static int	SO_DONTROUTE
static int	SO_ERROR
static int	SO_KEEPALIVE
static int	SO_OOBINLINE
static int	SO_RCVBUF
static int	SO_RCVLOWAT
static int	SO_RCVTIMEO
static int	SO_REUSEADDR
static int	SO_SNDBUF
static int	SO_SNDLOWAT
static int	SO_SNDTIMEO
static int	SO_TYPE
static int	SOCK_DGRAM
static int	SOCK_RAW
static int	SOCK_STREAM
static int	SOL_SOCKET
static int	TCP_NODELAY

Method Summary

int	accept(int socket, Socket.sockaddr_in remoteAddress, IntByReference address_len) accept a connection from a client
int	bind(int socket, Socket.sockaddr_in myaddress, int address_len) bind a socket to a port
int	connect(int socket, Socket.sockaddr_in address, int address_len) initiate a connection on a socket.
int	getsockopt(int socket, int level, int option_name, ByReference option_value, IntByReference option_len) get a socket option
String	inet_ntop(int af, IntByReference src, Pointer dst, int size) Takes an IPv4 Internet address and returns string representing the address in `.' notation
boolean	inet_pton(String str, IntByReference in_addr) Interprets the specified character string as an Internet address, placing the address into the structure provided.
int	listen(int socket, int backlog) listen for connections on socket
int	setsockopt(int socket, int level, int option_name, ByReference option_value, int option_len) set a socket option
int	shutdown(int socket, int how) initiate a connection on a socket.
int	socket(int domain, int type, int protocol) socket() creates an endpoint for communication and returns a descriptor.

Methods inherited from interface com.sun.cldc.jna.Library

initConstInt

Field Detail

INSTANCE

static final Socket INSTANCE

AF_INET

static final int AF_INET

SOCK_STREAM

static final int SOCK_STREAM

SOCK_DGRAM

static final int SOCK_DGRAM

SOCK_RAW

static final int SOCK_RAW

INADDR_ANY

static final int INADDR_ANY

INET_ADDRSTRLEN

static final int INET_ADDRSTRLEN

SOL_SOCKET

static final int SOL_SOCKET

SO_DEBUG

static final int SO_DEBUG

SO_ACCEPTCONN

static final int SO_ACCEPTCONN

SO_REUSEADDR

static final int SO_REUSEADDR

SO_KEEPALIVE

static final int SO_KEEPALIVE

SO_DONTROUTE

static final int SO_DONTROUTE

SO_BROADCAST

static final int SO_BROADCAST

SO_OOBINLINE

static final int SO_OOBINLINE

IPPROTO_TCP

static final int IPPROTO_TCP

TCP_NODELAY

static final int TCP_NODELAY

SO_SNDBUF

static final int SO_SNDBUF

See Also:

Constant Field Values

SO_RCVBUF

static final int SO_RCVBUF

See Also:

Constant Field Values

SO_SNDLOWAT

static final int SO_SNDLOWAT

See Also:

Constant Field Values

SO_RCVLOWAT

static final int SO_RCVLOWAT

See Also:

Constant Field Values

SO_SNDTIMEO

static final int SO_SNDTIMEO

See Also:

Constant Field Values

SO_RCVTIMEO

static final int SO_RCVTIMEO

See Also:

Constant Field Values

SO_ERROR

static final int SO_ERROR

See Also:

Constant Field Values

SO_TYPE

static final int SO_TYPE

See Also:

Constant Field Values

Method Detail

socket

int socket(int domain,
           int type,
           int protocol)

socket() creates an endpoint for communication and returns a descriptor.

Parameters:

domain - specifies a communications domain within which communication will take place; this selects the protocol family which should be used. The currently understood formats are: AF_UNIX, AF_INET, AF_ISO, AF_NS, AF_IMPLINK

type - specifies the semantics of communication. Currently defined types are: SOCK_STREAM, SOCK_DGRAM, SOCK_RAW, SOCK_SEQPACKET, SOCK_RDM

protocol - The protocol number to use is particular to the communication domain in which communication is to take place; see protocols(5).

Returns:

A -1 is returned if an error occurs, otherwise the return value is a descriptor referencing the socket.

connect

int connect(int socket,
            Socket.sockaddr_in address,
            int address_len)

initiate a connection on a socket.

Parameters:

socket - socket descriptor

address - ptr to a sockaddr_in buffer

address_len - pass in sockaddr_in.size()

Returns:

A -1 is returned if an error occurs, otherwise the return value is a descriptor referencing the socket.

bind

int bind(int socket,
         Socket.sockaddr_in myaddress,
         int address_len)

bind a socket to a port

Parameters:

socket - socket descriptor

myaddress - ptr to a sockaddr_in buffer

address_len - size of sockaddr_in

Returns:

A -1 is returned if an error occurs, otherwise the return value is a descriptor referencing the socket.

accept

int accept(int socket,
           Socket.sockaddr_in remoteAddress,
           IntByReference address_len)

accept a connection from a client

Parameters:

socket - socket descriptor

remoteAddress - ptr to a SockAddr_In buffer that will contain the address of the remote client

address_len - pointer to int containing the size of an IP address

Returns:

A -1 is returned if an error occurs, otherwise the return value is a descriptor referencing the socket.

listen

int listen(int socket,
           int backlog)

listen for connections on socket

Parameters:

socket - socket descriptor

backlog -

Returns:

A -1 is returned if an error occurs, otherwise the return value is a descriptor referencing the socket.

shutdown

int shutdown(int socket,
             int how)

initiate a connection on a socket.

Parameters:

socket - socket descriptor

how - If how is SHUT_RD, further receives will be disallowed. If how is SHUT_WR, further sends will be disallowed. If how is SHUT_RDWR, further sends and receives will be disallowed.

Returns:

A -1 is returned if an error occurs, otherwise zero is returned

inet_pton

boolean inet_pton(String str,
                  IntByReference in_addr)

Interprets the specified character string as an Internet address, placing the address into the structure provided. It returns 1 if the string was successfully interpreted, or 0 if the string is invalid

Parameters:

str -

in_addr - (OUT) on sucessful return will contain the 32 bits of an IPv4 "struct in_addr"

Returns:

true if success

inet_ntop

String inet_ntop(int af,
                 IntByReference src,
                 Pointer dst,
                 int size)

Takes an IPv4 Internet address and returns string representing the address in `.' notation

Parameters:

af - family (should be AF_INET)

src - a pointer to the src internet address

dst - a pointer to tmp buffer used to store characters for the result.

size - the size of the tmp dst buffer

Returns:

String (created from the characters in the dst buffer)

setsockopt

int setsockopt(int socket,
               int level,
               int option_name,
               ByReference option_value,
               int option_len)

set a socket option

Parameters:

socket - socket descriptor

level -

option_name -

option_value -

option_len - (option_value.size()

Returns:

A -1 is returned if an error occurs, otherwise the return value is a descriptor referencing the socket.

getsockopt

int getsockopt(int socket,
               int level,
               int option_name,
               ByReference option_value,
               IntByReference option_len)

get a socket option

Parameters:

socket - socket descriptor

level -

option_name -

option_value -

option_len - On return, the by-reference int will contain the size of the option_value data

Returns:

A -1 is returned if an error occurs, otherwise the return value is a descriptor referencing the socket.