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:

-gl:sckport port_number
    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.

ENVIRONMENT

DISPLAY
    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

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)