generate_port, try_bind_listen, try_connect, try_accept, register_server

generate_port([use_unix])

:: Generates a port number.

try_bind_listen(port)

:: Binds and listens on a port.

try_connect(host,port)

:: Connects to a port.

try_accept(socket,port)

:: Accepts a connection request.

register_server(control_socket,control_port,server_socket,server_port)

:: Registers the sockets for which connections are established.

return

integer or string for generate_port(), integer for the others

use_unix

0 or 1

host

string

port,control_port,server_port

integer or string

socket,control_socket,server_socket

integer

• These functions are primitives to establish communications between a client and servers.
• generate_port() generates a port name for communication. If the argument is not specified or equal to 0, a port number for Internet domain socket is generated randomly. Otherwise a file name for UNIX domain (host-internal protocol) is generated. Note that it is not assured that the generated port is not in use.
• try_bind_listen() creates a socket according to the protocol family indicated by the given port and executes bind and listen. It returns a socket identifier if it is successful. -1 indicates an error.
• try_connect() tries to connect to a port port on a host host. It returns a socket identifier if it is successful. -1 indicates an error.
• try_accept() accepts a connection request to a socket socket. It returns a new socket identifier if it is successful. -1 indicates an error. In any case socket is automatically closed. port is specified to distinguish the protocol family of socket.
• register_server() registers a pair of a control socket and a server socket. A process identifier indicating the pair is returned. The process identifier is used as an argument of ox functions such as ox_push_cmo().
• Servers are invoked by using shell(), or manually.

[340] CPort=generate_port();
39896
[341] SPort=generate_port();
37222
[342] CSocket=try_bind_listen(CPort);
3
[343] SSocket=try_bind_listen(SPort);
5

/*
ox_launch is invoked here :
%  ox_launch "127.1" 0 39716 37043 ox_asir "shio:0"
*/

[344] CSocket=try_accept(CSocket,CPort);
6
[345] SSocket=try_accept(SSocket,SPort);  
3
[346] register_server(CSocket,CPort,SSocket,SPort);
0

References

section ox_launch, ox_launch_nox, ox_shutdown, section ox_launch_generic, section shell, section ox_push_cmo, ox_push_local

Go to the first, previous, next, last section, table of contents.