Scroll to navigation

DCLSRV(1) GFD Dennou Club Library DCLSRV(1)

NAME

dclsrv - DCL graphics server for remote rendering via TCP/IP

SYNOPSIS

dclsrv [ options ]

DESCRIPTION

dclsrv is a graphics server program included in the GFD Dennou Club Library (DCL). It listens for incoming TCP/IP connections, receives DCL graphics commands sent by client programs, and renders them on the server's local display (typically an X Window System or GTK environment).

This utility allows for a client-server architecture where numerical calculations are performed on a remote machine (client), while the visualization is displayed on the local machine (server) running dclsrv.

Operation

1.
dclsrv starts and listens on a specified TCP port (determined by the SCKPORT parameter).
2.
A client program (linked with a DCL driver configured to use sockets) connects to this port.
3.
The client sends graphics primitives (e.g., "draw line", "set color", "draw text") over the network.
4.
dclsrv executes these commands and renders the result on the local screen.

OPTIONS

dclsrv accepts standard DCL runtime parameters. The most important parameter for this server is:

Specify the TCP port number to listen on.
The server binds to all available network interfaces (INADDR_ANY). Ensure this port is not blocked by a firewall if connecting from a remote machine.

Specify the output workstation type used for rendering (e.g., gtk, x).
Since dclsrv is intended to display graphics, a window-based workstation is usually selected.

ENVIRONMENT

When using X11 or GTK on Unix-like systems, this variable must be set to the target display (e.g., :0.0) where the graphics window should appear.

EXAMPLES

To start the server on the default port (configured in .dclrc or default system value):

$ dclsrv

To start the server listening on TCP port 9000:

$ dclsrv -gl:sckport=9000

To start the server using the GTK backend explicitly:

$ dclsrv -sw:ws gtk

SECURITY NOTES

dclsrv accepts connections from any IP address (INADDR_ANY) and does not implement authentication or encryption. It is strongly recommended to use this program only inside a trusted local network (LAN) or tunnel the connection through SSH for security.

AUTHORS

Youhei SASAKI <uwabami@gfd-dennou.org>, GFD Dennou Club

SEE ALSO

dclconfig(1), dclpar(1)

2026-01-23 DCL 7.5.2