GSR-KMS-SERVER(1)    GPU Screen Recorder KMS Server Manual   GSR-KMS-SERVER(1)

NAME
       gsr-kms-server - KMS (Kernel Mode Setting) server for GPU Screen
       Recorder

SYNOPSIS
       gsr-kms-server <domain_socket_path> <card_path>

DESCRIPTION
       gsr-kms-server is a companion daemon for GPU Screen Recorder that
       provides Kernel Mode Setting (KMS) access for screen capture in
       environments where direct DRM access is required. It acts as a local
       server that communicates via a Unix domain socket, allowing GPU Screen
       Recorder to capture screen content through the KMS interface.

       This component is typically used when GPU Screen Recorder needs to
       access display hardware directly, bypassing the windowing system for
       more efficient or lower-level capture. It runs as a separate process
       and communicates with the main GPU Screen Recorder instance.

ARGUMENTS
       domain_socket_path
              Path to the Unix domain socket that the server will create and
              listen on.  This socket is used for communication between GPU
              Screen Recorder and the KMS server. The path should be in a
              location where both processes have appropriate permissions to
              read and write.

       card_path
              Path to the DRM device file (typically /dev/dri/cardX) that the
              server will use for KMS operations. This corresponds to a
              specific graphics card in the system.

EXAMPLES
       Start the KMS server using card0 and create socket at /tmp/gsr-
       kms.sock:
              gsr-kms-server /tmp/gsr-kms.sock /dev/dri/card0

       Start the KMS server using card1 and create socket in a user-specific
       location:
              gsr-kms-server ~/.cache/gsr-kms.sock /dev/dri/card1

NOTES
       o  The gsr-kms-server typically runs with elevated permissions to
          access DRM devices, which requires root permission.

       o  Only one instance should run per DRM card at a time.

       o  The server will exit when the client disconnects or when terminated
          by a signal.

       o  The socket file is created by the server and removed when the server
          exits.

FILES
       /dev/dri/card*
              DRM device files for graphics cards

       /tmp/gsr-kms.sock
              Typical location for the domain socket (user-configurable)

SEE ALSO
       gpu-screen-recorder(1), drm(4)

       Project homepage: <https://git.dec05eba.com/gpu-screen-recorder/about/>

BUGS
       Report bugs at the project homepage.

AUTHORS
       gsr-kms-server was written by the GPU Screen Recorder contributors.

5.10.2                            2025-12-22                 GSR-KMS-SERVER(1)