借助网络配置,控制Modbus工具的日志显示,避免卡死界面
智能大石头 authored at 2021-12-11 22:09:19
3.34 KiB
XCoder
using System;
using System.Collections.Generic;
using System.IO;
using NewLife;
using NewLife.XCoder.Services;

namespace NewLife.XCoder.Tools.Platform;

/// <summary>串口权限检查结果</summary>
/// <param name="CanOpenSerial">当前用户是否可打开串口</param>
/// <param name="Reason">说明,界面直接展示</param>
public sealed record SerialPermission(Boolean CanOpenSerial, String Reason);

/// <summary>串口访问权限探测</summary>
/// <remarks>
/// Windows/macOS 打开串口不需要额外授权;Linux 需要用户属于 <c>dialout</c>(部分发行版为 <c>uucp</c>)组,
/// 否则 open 会报 Permission denied。这里只做「读取 /etc/group 判断」这类只读探测,
/// 不主动修改用户组(需要 root,且要重新登录才生效)。
/// </remarks>
public static class SerialPermissionProbe
{
    /// <summary>常见串口设备组</summary>
    public static IReadOnlyList<String> Groups { get; } = ["dialout", "uucp"];

    /// <summary>检查当前平台的串口权限</summary>
    /// <returns>检查结果</returns>
    public static SerialPermission Check()
    {
        if (!PlatformCapabilities.IsLinux) return new SerialPermission(true, LocalizationService.T("No additional permission required on this platform"));

        var user = Environment.UserName;
        var content = ReadGroupFile();
        if (content.IsNullOrEmpty()) return new SerialPermission(true, LocalizationService.T("Unable to read /etc/group; assuming access is allowed"));

        foreach (var group in Groups)
        {
            if (IsInGroup(content, user, group)) return new SerialPermission(true, LocalizationService.Format("User is already in the {0} group", group));
        }

        return new SerialPermission(false, LocalizationService.Format("Current user {0} is not in the dialout/uucp group; the serial port cannot be opened. Run: sudo usermod -aG dialout {0} (takes effect after re-login)", user));
    }

    /// <summary>判断用户是否在指定组内(解析 /etc/group 文本)</summary>
    /// <param name="groupFile">group 文件内容</param>
    /// <param name="user">用户名</param>
    /// <param name="group">组名</param>
    /// <returns>在组内返回 true</returns>
    public static Boolean IsInGroup(String? groupFile, String? user, String? group)
    {
        if (groupFile.IsNullOrWhiteSpace() || user.IsNullOrWhiteSpace() || group.IsNullOrWhiteSpace()) return false;

        foreach (var raw in groupFile!.Split('\n'))
        {
            var line = raw.Trim();
            if (line.Length == 0 || line.StartsWith("#", StringComparison.Ordinal)) continue;

            // 格式:group_name:password:GID:user_list
            var parts = line.Split(':');
            if (parts.Length < 4) continue;
            if (!String.Equals(parts[0], group, StringComparison.Ordinal)) continue;

            foreach (var member in parts[3].Split(',', StringSplitOptions.RemoveEmptyEntries))
            {
                if (String.Equals(member.Trim(), user!.Trim(), StringComparison.Ordinal)) return true;
            }

            return false;
        }

        return false;
    }

    private static String? ReadGroupFile()
    {
        try
        {
            return File.Exists("/etc/group") ? File.ReadAllText("/etc/group") : null;
        }
        catch
        {
            return null;
        }
    }
}