.th port IV 4/21/86
.sh NAME
port - create an interprocess communication channel
.sh SYNOPSIS
port(name, mode);
char *name;
char mode;
.sh DESCRIPTION
A port is an interprocess communication mechanism similar to UNIX
pipes, except that a port has multiple writers and a single reader
while a pipe has a single reader and a single writer.  The KSOS port
creates a shared memory segment which will be read by the process
issuing the port call.  The name specified in the port call is a
pathname of a file which will contain the seid of the shared memory
segment.  Other processes who wish to use the port to communicate with
the owner of the port need only read the specified file and open the
seid designated in the file.  Subsequent writes to the port's file
descriptor may be read by the owner of the port.  The mode parameter
is reserved for future use and should be set to zero.
.sh "SEE ALSO"
open (IV), read (IV), write (IV)
.sh DIAGNOSTICS
From C a -1 is returned if the caller cannot have any more open files,
or if the create of the specified pathname fails.
