rs2322tcp/internal/client/virtual_port_validation_linux.go

//go:build linux

/*
 * ============================================================================
 * Projekt.....: rs2322tcp
 * Datei.......: internal/client/virtual_port_validation_linux.go
 * Copyright (C) 2026 Dieter Lang
 *
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * Beschreibung:
 * Linux-spezifische Prüfung der lokal vorhandenen virtuellen
 * rs2322tcp-Schnittstellen gegen die Client-Konfiguration.
 * ============================================================================
 */
package client

import (
	"fmt"
	"strings"

	"git.lang-dieter.de/rs2322tcp/internal/config"
)

///////////////////////////////////////////////////////////////////////////////
// Local virtual-port validation
///////////////////////////////////////////////////////////////////////////////

// validateLocalVirtualPorts compares the virtual ports defined in
// client.json with the public symbolic links currently available on Linux.
//
// The check is read-only and does not require root privileges.
//
// A mismatch prevents the client from starting.
func validateLocalVirtualPorts(
	cfg *config.ClientConfig,
) error {
	if cfg == nil {
		return fmt.Errorf("client configuration is nil")
	}

	configured := make(
		[]string,
		0,
		len(cfg.VirtualPorts),
	)

	for _, virtualPort := range cfg.VirtualPorts {
		configured = append(
			configured,
			virtualPort.Port,
		)
	}

	available, err := existingVirtualPortLinks(
		cfg.VirtualPortRange,
	)
	if err != nil {
		return fmt.Errorf(
			"prüfen der virtuellen Ports fehlgeschlagen: %w",
			err,
		)
	}

	result := compareVirtualPorts(
		configured,
		available,
	)

	if len(result.Missing) == 0 &&
		len(result.Extra) == 0 {
		return nil
	}

	var message strings.Builder

	////////////////////////////////////////////////////////////////////////////
	// Missing ports
	////////////////////////////////////////////////////////////////////////////

	if len(result.Missing) > 0 &&
		len(result.Extra) == 0 {

		message.WriteString(
			"Virtuelle Ports nicht eingerichtet",
		)

		message.WriteString(
			"\n\nFolgende Ports sind in client.json " +
				"eingetragen, aber auf diesem Rechner " +
				"nicht eingerichtet:\n\n",
		)

		for _, port := range result.Missing {
			message.WriteString("  ")
			message.WriteString(port)
			message.WriteByte('\n')
		}

		message.WriteString(
			"\nBitte richten Sie diese virtuellen Ports " +
				"entsprechend der Installationsanleitung ein.",
		)

		return fmt.Errorf(
			"%s",
			strings.TrimSpace(message.String()),
		)
	}

	////////////////////////////////////////////////////////////////////////////
	// Extra ports
	////////////////////////////////////////////////////////////////////////////

	if len(result.Missing) == 0 &&
		len(result.Extra) > 0 {

		message.WriteString(
			"Virtuelle Ports nicht konfiguriert",
		)

		message.WriteString(
			"\n\nFolgende virtuelle Ports sind auf diesem " +
				"Rechner eingerichtet, aber nicht in " +
				"client.json eingetragen:\n\n",
		)

		for _, port := range result.Extra {
			message.WriteString("  ")
			message.WriteString(port)
			message.WriteByte('\n')
		}

		message.WriteString(
			"\nBitte ergänzen Sie die entsprechenden " +
				"Einträge in client.json.",
		)

		return fmt.Errorf(
			"%s",
			strings.TrimSpace(message.String()),
		)
	}

	////////////////////////////////////////////////////////////////////////////
	// Missing and extra ports
	////////////////////////////////////////////////////////////////////////////

	message.WriteString(
		"Virtuelle Portkonfiguration stimmt nicht überein",
	)

	message.WriteString(
		"\n\nIn client.json eingetragen, aber nicht " +
			"eingerichtet:\n\n",
	)

	for _, port := range result.Missing {
		message.WriteString("  ")
		message.WriteString(port)
		message.WriteByte('\n')
	}

	message.WriteString(
		"\nEingerichtet, aber nicht in client.json " +
			"eingetragen:\n\n",
	)

	for _, port := range result.Extra {
		message.WriteString("  ")
		message.WriteString(port)
		message.WriteByte('\n')
	}

	message.WriteString(
		"\nBitte korrigieren Sie die virtuelle " +
			"Portkonfiguration.",
	)

	return fmt.Errorf(
		"%s",
		strings.TrimSpace(message.String()),
	)
}