d — Inferno 1ed

d

ial, announce, export, listen - make network connections

include "sys.m";
sys:= load Sys Sys->PATH;
Connection: adt
{
  dfd: ref FD; # data file
  cfd: ref FD; # control file
  dir: string; # pathname of line directory
};
announce: fn(addr: string):          (int, Connection);
dial:     fn(addr, local: string):   (int, Connection);
listen:   fn(c: Connection):         (int, Connection);
export:   fn(fd: ref FD, flag: int):  int;

Description

These routines establish network connections.


dir	The pathname to the directory containing the network interface files for the connection. For example, /net/tcp/5.
dfd	A file descriptor to the data file of the connection. This is used to read and write data to the destination.
cfd	A file descriptor for the ctl file of the connection. Commands can be sent to this file to control the connection.

See the appropriate Network device pages (for example, ip - TCP, UDP network protocols over IP in Chapter 2) for further details of using this interface.

announce (addr)

The announce function and the listen function described in this section are the complements of the dial function. Their actions allow completion of connection requests from clients using the dial function.

The Argument, addr

The announce function establishes a network name (service port) to which incoming calls can be made. The format of the addr, the single argument is:

network!localname!serviceport

The localname component is translated (if possible) by the connection server. The result is stored in the local file of the network interface. That file can be used for display purposes. The localname value is not used by the underlying network. The setting of local file is skipped if localname is'*'.

The Connection Server

The announce function uses the connection server to translate any symbolic components of the argument to values acceptable to the network. See the cs daemon for a description of the supported translations.

The cs daemon is accessed by an interface file also called cs. The announce function looks for that file in two directories in the following order:

A directory named in an optional prefix to the addr argument. The format in such cases is: /dir/network!*!serviceport

The /net directory

The Return Value

The return value of the announce function follows the same conventions as used by the dial function. If the call succeeds, the returned Connection adt can be used as an argument to the listen function.

listen(c)

The listen function allows the completion of a connection to a process calling the dial function.

Argument

The listen function takes as its only argument the Connection adt of a successful call to announce.

Return Values

The return values from the listen function have the same form as those returned from the dial function.

When a call is received, listen includes an open Connection adt that leads to a network interface file. The data file of that interface is cross connected (read-to-write and write-to-read) to the data file associated with the Connection adt returned by the dial function to the client process.

export (fd, flag)

The export function responds to client requests for file operations on the server's file name space. This is the server end of a client's mount call.

NOTE:

Requests for pathname resolution occur relative to the current root directory of the process calling export. That process can control the set of files available for mounts requests by clients by defining the root directory of its name space using the operations described on the bind page.

Arguments

The export functions first argument is the dfd member of a Connection returned from listen on service port stags.

The export function can take two mutually exclusive flags


EXPWAIT	The export function blocks until all client requests are complete.
EXPASYNC	Client requests are handled by a background thread, while export returns immediately

Return Values

The export function returns 0 on success and -1 on failure.

Examples

Make a call and return an open file descriptor to use for communications:

callkremvax( ): (int, Connection)
{
    return sys->dial("tcp!kremvax!mpeg", nil);
}

Call the local authentication server:

dialauth(service: string): (int, Connection) { return sys->dial("net!$SIGNER!inflogin", nil); }

Museum

d — Inferno 1ed

d

Description

dial (addr, local)

The addr Argument

The Connection Server

The local Argument

The Return Values

announce (addr)

The Argument, addr

The Connection Server

The Return Value

listen(c)

Argument

Return Values

export (fd, flag)

Arguments

Return Values

Examples

See Also