dglope(3G)dglope(3G)NAMEdglope - opens a Graphics Library connection to a graphics server
FORTRAN 77 SPECIFICATION
integer*4 dglope(svname, length, type)
character*(*) svname
integer*4 length, type
PARAMETERS
svname expects a variable containing the name of the graphics server to
which you want to open a connection.
For a successful connection, the client host must have
permission to connect to the graphics server. Authentication is
accomplished via the same mechanisms as for X clients. See
xhost(1) for further details.
The svname parameter has the following syntax:
[[username ]password@]hostname[:server[.screen]]
where hostname is an internet host name recognized by
gethostname(3N). server and screen are ignored, and both are
set to 0.
For DECnet connections, if the server account has a password,
this password must be specified by including username and
password. This password is used only for opening the DECnet
connection; the local and remote accounts must still be
equivalent in the rlogin sense.
length expects the length of the string in svname.
type expects a symbolic constant that specifies the kind of
connection. There are three defined constants for this
parameter:
DGLLOC indicates a direct connection to the local graphics
hardware. This type of connection is not supported on client
machines without IRIS graphics hardware.
DGLTSO indicates a remote connection via TCP/IP.
DGL4DD indicates a remote connection via DECnet.
FUNCTION RETURN VALUE
If the connection succeeds, the returned value of the function is a non-
negative integer, serverid, that identifies the graphics server. If the
connection failed, the returned value for the function is a negative
integer. The absolute value of a negative returned value is either a
standard error value (defined in <errno.h>) or one of several error
returns associated specifically with dglope:
Page 1
dglope(3G)dglope(3G)
ENODEV type is not a valid connection type.
EACCES login incorrect or permission denied.
EMFILE too many graphics connections are currently open.
ENOPROTOOPT DGL service not found in /etc/services.
ERANGE invalid or unrecognizable number representation.
EPROTONOSUPPORT
DGL version mismatch.
ESRCH the window manager is not running on the server.
DESCRIPTIONdglope opens a Graphics Library connection to a graphics server (svname).
After a connection is open, all graphics preferences, input, and output
are directed to that connection. This direction is continued until
either the connection is closed, another connection is opened, or a
different connection is selected. A different connection can be selected
by calling a subroutine that takes a graphics window identifier as an
input parameter, e.g. winset. The server connection associated with that
graphics window identifier becomes the current connection. To close a
connection, call dglclo with the server identifier returned by dglope.
If a remote server error occurs, the graphics application may exit with a
status value EIO and produce the following error message:
dgl error (comm): read returned 0
SEE ALSO
dglclo, finish, gflush, winope, winset, scrnse
rlogin(1C), gethostbyname(3N) in the IRIS-4D User's Reference Manual
NOTES
This routine is available only in immediate mode.
This routine is available in both the GL and DGL libraries. However, the
DGLLOC connection type is not supported by the DGL library.
Page 2
